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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 


Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  and  information 
models . 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 


Role 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-size  business. 

Rev i ewer . 


Northrop  Corporation  Responsible  for  factory  view 

function  and  information 
models . 


Pritsker  and  Associates 
SofTech 


Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


A 

TASKS  4.3  -  4.9  (TEST  BED) 


Subcontractors 


Role 


Boeing  Military  Aircraft 
Company  (BMAC) 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
(DACOM) 


1 

J 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


iv 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(Me Auto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  0  Dodge) 


SofTech,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
( BMAC) 


Enhancements  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) . 


1701.  2201. 
2202 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhancements  to 
User  Interface/ Virtual 
Terminal  Interface 
CUI/VTI) . 

Systran 

1502 

Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Ident i f i cat i on 

This  specification  establishes  the  'as  built'  design  of  the 
Communications  Subsystem. 

1 • 2  Functional  Summary 

The  CoBmuni cat ions  Subsystem  provides  the  mechanism  for 
transporting  messages  between: 

(1)  Two  computers  running  the  Integrated  Information 
Support  System 

(2)  Two  processes  running  under  the  Integrated 
Information  Support  System 

The  portion  that  performs  the  first  function  is  referred  to  as 
COMM;  the  second  function  is  performed  by  a  set  of  routines 
that  is  referred  to  as  the  Interprocess  Communication  Primitives 
or  IPC's. 

COMM  uses  asynchronous  lines  to  support  the  transmission  of 
messages  between  two  computers.  The  communications  protocol 
used  across  the  lines  is  contention  until  a  session  is  started 
at  which  time  it  switches  to  half  duplex,  interleaved, 
bidirectional  message  transmissions.  COMM  will  deliver  messages 
to  its  peer  on  the  remote  computer  in  the  order  in  which  they 
are  received  from  the  Network  Transaction  Manager.  Messages  may 
be  variable  in  length.  If  the  message  is  larger  that  a 
transmission  block,  COMM  will  segment  the  message  and  reassemble 
it  at  the  receiving  end.  If  the  message  is  smaller  than  a 
transmission  block,  COMM  will  transmit  only  the  message  plus 
seven  (7)  characters.  A  longitudinal  redundancy  check  is 
applied  to  each  message  to  maintain  message  integrity.  Messages 
are  given  a  sequence  number  to  ensure  no  messages  are  lost. 
Transmission  failures  or  receiving  a  non-acknowledgment  will 
result  in  the  retransmission  of  the  message.  If  either  or  both 
of  these  conditions  occur  consecutively  for  a  specified  number 
of  times,  the  link  between  the  two  computers  is  assumed  to  be 
down  and  is  reported  to  the  Network  Transaction  Manager  as  such. 
Random  unsuccessful  transmissions  or  receptions  of  a  message  are 
logged  as  recoverable  errors. 
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COMM  never  terminates  because  of  the  status  of  the  link  to 
the  other  computer.  It  will  terminate  only  if  it  receives  an 
illegal  command  from  the  Network  Transaction  Manager  or  if  it 
fails  to  initialize  the  asychronous  line  (terminal  port)  on 
start-up. 

Messages  must  be  classified  as  containing  either  binary 
data  or  native  data.  Binary  data  is  converted  to  the  native 
data  representation  of  each  nibble  (4  bits)  for  transmission, 
then  converted  back  to  binary  for  delivery  of  the  message  at  the 
receiving  end.  There  is  no  translation  of  native  data  except 
for  control  characters.  Control  characters  can  be  used  in 
native  data  messages  in  which  case  they  are  translated  to  two 
characters  for  transmission.  The  two  characters  are  a  special 
character  to  indicate  special  processing  is  required  on  the 
following  character  and  a  character  that  indicates  which  control 
character.  The  special  character  is  the  exclamation  mark  (!). 

Translation  between  EBCDIC  and  ASCII,  necessary  to  support 
communications  between  the  IBM  and  non-IBM  environments,  is 
performed  by  a  hardware  protocol  converter. 

The  configuration  of  the  network  is  point-to-point; 
therefore,  there  is  a  COMM  process  running  on  each  computer  for 
each  remote  computer  in  the  Integrated  Information  Support 
System. 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 

The  following  pertinent  reference  materials  are  available 
at  the  ICAM  Program  Office. 


1.  Interim  Reports 


2. 


Life  Cycle  Documents 

(a)  ITR6201 50002U  Pro.ject  Scope 

(b)  PMP620 150000  Master  Plan  and  Schedule 

(c)  SAD620 150000  State-of-the-art  Rev i ew 

(d)  SRD620 1 40000  System  Requirements  Document 

(e)  SDS620 140000  System  Design  Specifications 

(f)  DS6201430000  Development  Specification  - 

Communications  Subsystem 


The  following  reference  materials  are  available  from 
Digital  Equipment  Corporation. 


(a)  VAX/VMS  I /0  User ' s  Guide  (Volume  1),  Order  No. 
AA-M540B-TE 

(b)  VAX /VMS  I/O  User  1 s  Guide  (Volume  2),  Order  No. 
AA-M541B-TE 

(c)  VAX  COBOL  Language  Reference  Manual .  Order  No. 
AA-H631C-TE 

(d)  VAX- 11  FORTRAN  Language  Reference  Manual ,  Order 
No .  AA-D034C-TE 


Other  reference  materials  are  as  follows. 

(a)  International  Organization  for  Standardization, 
Open  Systems  Interconnection,  Informat i on 
Processing  Systems  -  Basic  Reference  Model,  TC 
97/16  N  719 

(b)  International  Organization  for  Standardization, 
Open  Systems  Interconnection,  Draft  - 
Connection-Oriented  Transport  Service  Definition 
TC  97/16  N  860 

na 
Sy 
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Connect i on-Or i ented  Transport  Protocol 
Specification  Version  1.2,  TC  97/16  N  861 

(d)  International  Organization  for  Standardization, 
Open  Systems  Interconnection,  Draft  - 
Connect i on-Or i ented  Session  Protocol  Definition 
TC  97/16  N  856 

(e)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol,  Volume  2:  Basic  Class 
Protocol ,  Draft  Report ,  September  1981,  Report 
No.  ICST/HLNP-81-12 

(f)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol,  Volume  3:  Extended  Class 
Protocol ,  Draft  Report.  September  1981,  Report 
No.  ICST/HLNP-81-13 

Cg)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol,  Volume  4:  Network 
Interfaces .  Draft  Report ,  September  1981,  Report 
No.  ICST/HLNP-81-14 

2.2  Terms  And  Abbreviations 

1.  Longitudinal  Redundancy  Check  -  The  summation  of  all 
the  bytes  in  a  message.  It  becomes  three  bytes  that 
are  attached  to  the  end  of  the  message  to  ensure  its 
integrity . 

2.  Interhost  Communication  Primitives  ( IHC ' s )  -  A  set  of 
routines  used  by  COMM  to  interface  to  the  operating 
system  and  the  terminal  driver.  They  are  always 
system  dependent . 

3.  Interprocess  Commun i cat i on  Primitives  ( I PC ' s )  -  A  set 
of  routines  used  to  communicate  between  two  processes 
on  the  same  computer.  They  are  always  system 
dependent . 
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SECTION  3 
REQUIREMENTS 


3. 1  Structural  Descriptions 

The  overall  structure  of  COMM  is  similar  to  that  of  a 
device  driver.  It  runs  asynchronously  in  response  to 
interrupts.  After  COMM  is  initialized,  it  waits  to  receive  a 
message,  either  from  the  Network  Transaction  Manager  or  from 
COMM  on  the  remote  computer . 

The  four  (4)  top  level  components  of  COMM  process  its  four 
possible  states. 

(1)  Session  Inactive  (ACTSES) 

(2)  Session  Active,  Line  Idle  ( IDLINE) 

(3)  Session  Active,  Line  Bid  (LBRESP) 

(4)  Session  Active,  Line  Active  (ALINPS) 

See  the  hierarchy  charts  in  Section  3.10.10  for  the  complete 
structure  of  COMM. 

3.2  Functional  Flow  Description 

In  each  of  the  four  states,  COMM  performs  different 
activities.  In  state  one  (Session  Inactive),  COMM  is  waiting  for 
the  Network  Transaction  Manager  to  send  a  control  message 
requesting  that  a  connection  be  made  to  COMM  on  the  remote 
computer.  While  in  state  one,  all  messages  for  COMM  from  the 
remote  computer  are  ignored. 

Upon  receiving  the  "start  link"  message  from  the  Network 
Transaction  Manager  and  the  correct  response  for  COMM  on  the 
remote  computer,  COMM  moves  to  the  second  state  (Session 
Active.  Line  Idle).  In  state  two,  COMM  is  waiting  for: 

(1)  A  message  from  the  Network  Transaction  Manager 
that  must  be  sent  to  its  peer  process  on  the 
remote  computer  or  a  control  message  to  shutdown, 
or 

(2)  A  Line  Bid  from  COMM  on  the  remote  computer 
indicating  it  has  at  least  one  message  from  its 
Network  Transaction  Manager  that  must  be  sent. 

If  a  message  is  received  from  the  Network  Transaction 
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Manager  for  transmission  to  it  peer  process  on  the  remote 
computer,  COMM  moves  to  the  third  state  (Session  Acive,  Line 
Bid)  and  transmits  a  line  bid  to  COMM  on  the  remote  computer. 
When  the  acknowledgment  for  the  line  bid  is  received  from  the 
remote  computer,  COMM's  state  changes  to  four  (Session  Active. 
Line  Active). 

In  state  four,  messages  are  received  and  transmitted  in  a 
bidirectional,  half  duplex,  interleaved  mode  until  neither  COMM 
program  has  a  message  to  send.  At  this  time  the  master  for 
that  session  sends  an  End  Of  Transmission  (EOT)  message  and 
both  COMM's  return  to  state  two  (Session  Active,  Line  Idle). 

If,  while  in  state  two,  COMM  receives  a  Line  Bid  request 
from  the  remote  COMM,  it  transmits  an  acknowledgment  and  moves 
to  state  four  to  receive  messages  from  the  remote  computer  and 
transmit  any  message  it  receives  from  the  Network  Transaction 
Manager  during  this  session. 

If  there  is  a  collision  of  Line  Bid  requests,  both  COMM's 
apply  a  backoff  algorithm  so  that  one  COMM  will  retransmit  the 
Line  Bid  ahead  of  the  other. 

If  the  transmission  is  lost  (no  response  from  the  remote 
computer  over  a  period  of  time  during  which  several 
retransmissions  are  made),  COMM  reverts  to  state  one  (Session 
Inactive)  and  sends  a  message  to  the  Network  Transaction  Manager 
indicating  that  the  link  has  failed. 

3 . 3  Interfaces 

COMM  communicates  with  only  one  process,  the  Network 
Transaction  Manager,  from  which  it  receives  control  directions 
and  messages  to  be  sent  to  the  remote  computer.  In  turn,  COMM 
sends  the  NTM  messages  received  from  the  remote  computer  and 
the  status  of  the  communications  line.  The  interface  between 
COMM  and  the  Network  Transaction  Manager  is  performed  by  the 
Interprocess  Communication  Primitives  (IPC's). 

Communications  with  the  remote  computer  is  accomplished 
through  the  terminal  drivers  for  the  respective  computers.  The 
interface  to  each  terminal  driver  is  through  a  set  of  routines 
referred  to  as  the  Interhost  Communication  Primitives  (IHC's). 
Section  3.2.6  of  the  Communication  Subsystem  Development 
Specification  presents  detailed  descriptions  of  each  IHC,  its 
inputs  and  its  outputs. 
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3.4  Program  Interrupts 

As  mentioned  previously,  COMM  is  interrupt  driven  with 
interrupts  coming  either  from  the  IPC's  on  behalf  of  the 
Network  Transaction  Manager  or  from  the  IHC's  on  behalf  on  the 
operating  system  terminal  driver  that  has  received  a  message 
from  COMM  on  the  remote  computer.  Waiting  for  these  interrupts 
is  performed  by  one  of  the  IPC  wait  primitives.  If  a  response 
must  be  received  within  a  particular  time  interval,  the  IPC's 
associated  with  timing  are  used  along  with  one  of  the  wait's. 

3.5  Timing  And  Sequence  Description 

Timing  and  sequencing  is  relevant  to  COMM  only  after  a  Line 
Bid  has  been  received  from  COMM  on  the  remote  computer.  At  this 
time,  the  half  duplex,  bidirectional,  interleaved  message 
transmission  protocol  begins  between  the  two  COMM's.  Messages 
must  be  received  from  the  remote  COMM,  processed  to  determine 
if  the  message  should  be  ack'ed  or  nack'ed,  and  sent  on  to  the 
Network  Transaction  Manager  if  complete.  Also,  messages  from 
the  Network  Transaction  Manager  must  be  received,  prepared  for 
transmission  and  built  into  a  message  with  the  status  of  the 
message  received  from  the  remote  COMM.  Finally,  the  message 
must  be  sent  to  the  remote  COMM  before  it  decides  that  its 
message  must  have  been  lost  and  retransmits  it.  Although 
retranmissions  are  processed  correctly  by  the  receiving  COMM, 
for  performance  reasons  it  is  better  that  this  situation  not 
occur . 

All  this  timing  and  sequencing  activity  occurs  in  state 
four  (Session  Active,  Line  Active)  and  is  under  the  control  of 
the  computer  program  component  Active  Line  Response  (ALRESP). 

The  primary  CPC's  used  to  perform  the  work  are 

(1)  Process  Input  Message,  If  Present  (PINPMS) 

(2)  Process  Output  Message  (POUTMS) 

(3)  Complete  and  Transmit  Message  (KPLXMT) 

3.6  Special  Control  Features 

The  Communications  Subsystem  does  not  include  any  special 
control  features  as  defined  in  the  ICAM  Documentation  Standards 
manual . 
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3.7  Storage  Allocation 

3.7.1  Data  Base  Definition 

3. 7. 1.1  File  Description 
GOMM  does  not  use  files. 

3. 7. 1.2  Table  Description 

COMM  has  a  set  of  tables  used  for transformations  needed  to 
successfully  transmit  messages  containing  control  characters  and 
a  set  of  tables  to  calculate  the  longitudinal  redundancy  check 
in  both  the  ASCII  and  EBCDIC  environments.  Both  sets  of  tables 
are  described  in  the  Communications  Subsystem  Development 
Specification  manual ,  Section  3. 2. 1.4,  Interface  Between  IBM  and 
non-IBM  Computers. 

3. 7. 1.3  Item  and  Constant  Description 

The  format  of  the  message  transmitted  between  the  two 
GOMM's  is  also  described  in  the  DS,  section  3.2.2,  Message 
Format . 
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There  are  also  a  set  of  constants  referred  to  as  the  COMM 
systea  parameters .  They  are 

•  COMM  CONFIGURATION  PARAMETERS 

01  FLAGS. 


03 

PRIMARY 

PIC 

X. 

03 

MAX-RETRY 

PIC 

99  VALUE  3. 

TIME  INTERVAL  SETTINGS 

03 

MASTER-TIME 

PIC 

9(6) 

VALUE 

15. 

03 

SLAVE-TIME 

PIC 

9(6) 

VALUE 

135. 

03 

PRIMARY-CONTENTION-TIME 

PIC 

9(6) 

VALUE 

5. 

03 

SESSION-NOT-ACTIVE-RESP-TIME 

PIC 

9(6) 

VALUE 

300. 

SYMBOLS  INDICATING  IISS  COMPUTERS 

03 

HOST-COMPUTER 

PIC 

X. 

03 

TARGET-COMPUTER 

PIC 

X. 

* 

*  BUFFER  SIZES 

* 

01  MAILBOX-MAX-BUFFER-SIZE  PIC  9(4)  VALUE  2000. 

01  LAN-MAX-BUFFER-SIZE  PIC  9(4)  VALUE  253. 

* 

*  TERMINAL  DESIGNATOR 

* 

01  PORT-NAME  PIC  X(12). 

* 

3.7.2  CPC  Relationship 

The  items  and  constants  listed  in  section  3. 7. 1.3  are  used 
throughout  COMM  as  a  basis  for  decision  making.  The  tables, 
however,  are  used  only  in  specific  CPC's  that  perform 
transformations.  The  table  to  process  control  characters  in 
messages  received  from  the  remote  COMM  is  used  in  KMINDA ,  the 
routine  that  compresses  the  data  in  the  receiving  buffer.  The 
table  exists  in  the  include  file  CTLASC.INC  for  the  non-IBM 
environment  and  CTLEBC.INC  for  the  IBM  computers.  The  table 
that  is  used  in  the  longitudinal  redundancy  check  calculation 
and  to  transform  control  characters  for  transmission  is 
referenced  in  two  routines:  EXOUDA,  Expand  NTM  Data,  and  KLCLRC , 
Calculate  Longitudinal  Redundancy  Check.  The  table  exists  in 
the  include  file  ASCII. INC  for  the  non-IBM  environment  and  in 
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EBCDIC. INC  for  IBM  computers. 

3.8  Object  Code  Creation 

The  generic  portion  of  COMM  is  written  in  COBOL  and  has 
been  successfully  compiled  on  a  VAX  11/780  under  VMS,  an  IBM 
3084  under  MVS,  and  a  Honeywell  Level  6  under  Mod  400. 

The  IHC's  are  routines  that  interface  to  the  operating 
system  of  a  particular  computer.  On  the  VAX  they  are  written  in 
COBOL  and  FORTRAN.  On  the  IBM,  they  are  written  in  Assembler. 

On  the  Honeywell  Level  6,  they  are  written  in  COBOL  and 
Assembler.  The  IPC's  are  also  routines  that  interface  to  the 
operating  system.  They  are  written  in  the  same  languages  as  the 
IHC ' s . 

The  minimum  computer  hardware  and  software  required  to 
create  and  run  COMM  in  the  IISS  environment  is  documented  in  the 
Installation  Guide  for  IISS  on  the  VAX  and  in  the  Installation 
Guide  for  IISS  on  the  IBM. 

3.9  Adaption  Data 

In  order  to  tailor  COMM  to  either  the  VAX  or  the  IBM,  there 
are  a  few  system  dependent  files  required.  For  example,  the 
tables  for  control  character  processing  and  calculation  of  the 
longitudinal  redundancy  check  depend  upon  whether  the  native 
character  set  is  ASCII  or  EBCDIC. 

The  other  location  for  adaption  data  in  COMM  is  in  the 
initialization  subroutine.  The  subroutine  is  tailored  with 
ini tal izat ion  data  for  a  specific  terminal  port;  thus,  there  is 
one  for  each  remote  computer.  This  limitation  could  be  removed 
with  the  implementation  of  system  data  storage  in  the  Common 
Data  Model . 

The  command  procedures  to  the  create  COMM  executable  and 
the  IPC  library  are  specific  to  each  computer  and  can  be  found 
under  Software  Configuration  Management. 
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The  upcoming  program  details  were  derived  from  all  modules 
that  were  selected  when  the  following  Documentation  Group(s)  was 
chosen : 


COMMVAX 


3.10.1  Main  Program  List 


The  following  is  a  list  of  all  “Main  Programs'*  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or.  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 


•tf 


$ 

i 

i 


$ 


PS  620143100 
1  November  1985 


Module  Marne 


COMVH 


COMM  Main  Program  List 
Purpose 


COM  VI 


MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


I 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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Module 

ACTSES 

ALINPS 

ALRESP 

CNLLAN 

CNLTRM 

OOMVH 

CX)M  VI 

OACSES 

EXOUDA 

GETLAN 

GOOTMS 

IDLINE 

INILAN 

INITRM 

INTVH 

INTV  I 

KLCLRC 

KMINDA 


COMM  Module  List 
Name  Purpose 

ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 
WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 
RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
CANCEL  TERMINAL  10 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

REPORT  A  SESSION  FAILURE  TO  NTM 

EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 

GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

GET  A  MESSAGE  FROM  NTM 
PROCESS  INPUT  OR  TIMER  RUNOUT 
INITIALIZE  THE  LAN  TERMINAL  INTERFACE 
INITIALIZE  THE  TERMINAL  LINE 
INITIALIZE  COMM  VARIABLES 
INITIALIZE  COMM  VARIABLES 
CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 
COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 


KPLXMT 


PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
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COMM  Module  List 
Module  Name  Purpose 


LBRESP 

LINBID 

PARITY 

PINPMS 

POUTMS 

PURGE 

RCV5H 

RCVIBM 

RCVLAN 

RCVTRM 

REPTER 

SCTLMS 

SETCHR 
SETS PD 
STRTIM 


PROCESS  RESPONSE  TO  LINE  BID 

TRANSMIT  A  LINE  BID  MESSAGE 

SET  CHANNEL  TO  EVEN  PARITY 

PROCESS  MESSAGE  FROM  OTHER  COMM 

MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

CLEAR  THE  TYPE  AHEAD  BUFFER 

RECEIVE  5  CURSORS  FROM  THE  IBM 

READ  TERMINAL  LINE  FROM  PROTOCOL 
CONVERTER  ** 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 

READ  TERMINAL  LINE  WITH  EVENT  FLAG 

REPORT  RECOVERABLE  ERROR  TO  NTM 

REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 
NTM 

SET  TERMINAL  CHARACTERISTICS 

INITIALIZE  THE  TERMINAL  SPEED 

SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 


S  TRCVH1  TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 
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Module 

TRCVH2 

TRMLAN 

UDRSQN 

UDXSQN 

W1RESP 

XMTLAN 

XMTMSG 


COMM  Module  List 
Name  Purpose 

TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

RELEASE  THE  PORT  TO  THE  LAN 

UPDATE  RECEIVE  SEQUENCE  NUMBER 

UPDATE  TRANSMIT  SEQUENCE  NUMBER 

WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

TRANSMIT  TO  A  LAN  TERMINAL  LINE 

TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


XMTTRM 


TRANSMIT  TO  THE  TERMINAL  LINE 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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COMM  External  Routines  List 


Module  Name 

First  User 

CNLTIM 

ALINPS 

DELMBX 

COM  VI 

ERRPRO 

INTV  I 

FREVTF 

CNLLAN 

GETMSG 

GOUTMS 

INICOM 

INTV  I 

INSTNC 

SCTLMS 

LIBSGET  EF 

RCVTRM 

RCVMSG 

INTVH 

RELEVB 

COM  VI 

SETTIM 

PINPMS 

SNDMSG 

PINPMS 

SYS $ ALLOC 

INITRM 

SYSSASSIGN 

INITRM 

SYS $ CANCEL 

CNLTRM 

SYSSQIO 

RCVIBM 

SYSSQIOW 

XMTTRM 

SYSSSETPRI 

RCVTRM 

TRMNAX 

GOMVH 

WAIT01 

ACTSES 

WAIT02 

LBRESP 

WAIT03 

IDLINE 

V1FTrjjr»,«Vwv'r.'!rjfy  wv.  r_'  r.1  *•'  T\?rj  rj  w>’r^w>.'  *vr 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "***•  PURPOSE  NOT  FOUND  BY  STRIPPER  ****“ 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  ‘C‘  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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OOMM  Include  File  List 
File  Marne  Purpose 


ASCII  ASCII-  INCLUDE  FILE 

CAHHDR  CHXSTS . INC  —  CHECK  STATUS 

CHKSTS  CHKSTS . INC  —  CHECK  STATUS 

COMOON  GOMOOH  -  INCLUDE  FILE 

COMFLG  COMFLG  -  INCLUDE  FILE 

CTLASC  CTLASC  -  INCLUDE  FILE 

ERRPRO  PROCESS  ERROR  INCLUDE  FILE 

ERRSTS  ERRSTS . INC  —  IISS  ERROR  CODES 

ERRSTS . INF  **»*  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 

LANEVB  LANEVB . INC  —  LAN  TERMINAL  EVENT  BLOCK  DESCRIPTION 

NHSNEB  NHSNEB  -  INCLUDE  FILE 

NLSNEB  NLSNEB  -  INCLUDE  FILE 

NRCVEB  NRCVEB  -  INCLUDE  FILE 

NTMHDR  NTMHDR  -  INCLUDE  FILE 

NTMINB  NTMINB  -  INCLUDE  FILE 

NTMOUB  NTMOUB  -  INCLUDE  FILE 

RCVBLK  RCVBLK  -  INCLUDE  FILE 

RPTERR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

TIMEVB  TIMEVB . INC  —  TIME  EVENT  BLOCK  DESCRIPTION 
XMTBLK  XMTBLK  -  INCLUDE  FILE 
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COMM  Where- include-f i le-used  List 


Include 

File 

Module 

Name 

Module 

Purpose 

ASCII 

EXOUDA 

KLCLRC 

EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 

CANHDR 

SCTLMS 

REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 
NTM 

CHKSTS 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CNLLAN  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
GETLAN  GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

GOUTMS  GET  A  MESSAGE  FROM  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INILAN  INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

LINBID  TRANSMIT  A  LINE  BID  MESSAGE 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 

POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 

BUFFER 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 
REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 

SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 

NTM 
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COMM  Where- include-f ile-used  List 

Include  Module  Module 

File  Naae  Purpose 


STRTIM  SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


COMCON 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
GOUTMS  GET  A  MESSAGE  FROM  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

KMINDA  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 
KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

LINBID  TRANSMIT  A  LINE  BID  MESSAGE 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 

POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 
STRTIM  SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 

TRCVH1  TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 

TRCVH2  TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

UDRSQN  UPDATE  RECEIVE  SEQUENCE  NUMBER 

UDXSQN  UPDATE  TRANSMIT  SEQUENCE  NUMBER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 
XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 
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COMM  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


COMFLG 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INTVH  INITIALIZE  COMM  VARIABLES 

INTV I  INITIALIZE  COMM  VARIABLES 

KLCLRC  CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 
KMINDA  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 
KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
LINBID  TRANSMIT  A  LINE  BID  MESSAGE 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 
REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 

SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 

NTM 

STRTIM  SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


CTLASC 

KMINDA  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 
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COMM  Wbere-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


ERRPRO 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CNLLAN  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
GETLAN  GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

GOUTMS  GET  A  MESSAGE  FROM  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
LINBID  TRANSMIT  A  LINE  BID  MESSAGE 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 
REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 

SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 

NTM 

STRTIM  SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


ERRSTS 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 
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COMM  Where-include-f i le-used  List 

Include  Module  Module 

File  Majne  Purpose 


ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 
ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CNLLAN  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
GETLAN  GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

GOUTMS  GET  A  MESSAGE  FROM  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INILAN  INITIALIZE  THE  LAN  TERMINAL  INTERFACE 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 

REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 

TRCVH1  TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 

TRCVH2  TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


ERRSTS . INF 

CNLTRM  CANCEL  TERMINAL  10 

INITRM  INITIALIZE  THE  TERMINAL  LINE 

PARITY  SET  CHANNEL  TO  EVEN  PARITY 

PURGE  CLEAR  THE  TYPE  AHEAD  BUFFER 

RCV5H  RECEIVE  5  CURSORS  FROM  THE  IBM 

RCVIBM  READ  TERMINAL  LINE  FROM  PROTOCOL 

CONVERTER  ** 

RCVTRM  READ  TERMINAL  LINE  WITH  EVENT  FLAG 
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COMM  Where- include-f i le-used  List 


Include  Module  Module 

File  Name  Purpose 


SETCHR  SET  TERMINAL  CHARACTERISTICS 

SETSPD  INITIALIZE  THE  TERMINAL  SPEED 

XMTTRM  TRANSMIT  TO  THE  TERMINAL  LINE 


LANEVB 

ACTSES 

ALINPS 

ALRESP 

CNLLAN 

COMVH 

COM VI 

GETLAN 

IDLINE 

INILAN 

INTVH 

INTVI 

KPLXMT 

LBRESP 

LINBID 

RCVLAN 

TRMLAN 

W1RESP 

XMTLAN 

XMTMSG 


ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 
WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 
RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

PROCESS  INPUT  OR  TIMER  RUNOUT 

INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

INITIALIZE  COMM  VARIABLES 

INITIALIZE  COMM  VARIABLES 

PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

PROCESS  RESPONSE  TO  LINE  BID 

TRANSMIT  A  LINE  BID  MESSAGE 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 

RELEASE  THE  PORT  TO  THE  LAN 

WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

TRANSMIT  TO  A  LAN  TERMINAL  LINE 

TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


NHSNEB 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


3-23 
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COMM  Where- i nc 1 ude-f i le-used  List 


Include 

File 


Module 

Name 


Module 

Purpose 


COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

DACSES  REPORT  A  SESSION  FAILURE  TO  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 

SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 

NTM 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


NLSNEB 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 
ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 


NRCVEB 

ACTSES 

ALINPS 

ALRESP 

COMVH 

COM  VI 

GOUTMS 

IDLINE 

INTVH 

INTV  I 

LBRESP 

POUTMS 


ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

GET  A  MESSAGE  FROM  NTM 

PROCESS  INPUT  OR  TIMER  RUNOUT 

INITIALIZE  COMM  VARIABLES 

INITIALIZE  COMM  VARIABLES 

PROCESS  RESPONSE  TO  LINE  BID 

MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 

BUFFER 


PS  620143100 
1  November  1985 


OOMM  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


NTMHDR 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 

GOUTMS  GET  A  MESSAGE  FROM  NTM 
IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 


NTMINB 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 
INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

KMINDA  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 


NTMOUB 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

EXOUDA  EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
GOUTMS  GET  A  MESSAGE  FROM  NTM 
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COMM  Where- inc lude-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 

INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 

BUFFER 


RCVBLK 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CNLLAN  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

GETLAN  GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 

INILAN  INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

INTVH  INITIALIZE  COMM  VARIABLES 

INTVI  INITIALIZE  COMM  VARIABLES 

KMINDA  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 

KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

LINBID  TRANSMIT  A  LINE  BID  MESSAGE 

PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 

TRCVH1  TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 

TRCVH2  TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

TRMLAN  RELEASE  THE  PORT  TO  THE  LAN 

UDRSQN  UPDATE  RECEIVE  SEQUENCE  NUMBER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


RPTERR 
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COMM  Where-include-f i le-used  List 


Include 

File 


Module 

Name 


Module 

Purpose 


ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 


TIMEVB 

ACTSES 

ALINPS 

ALRESP 

COMVH 

COM  VI 

IDLINE 

KPLXMT 

LBRESP 

LINBID 

PINPMS 

STRTIM 

W1RFSP 

XMTMSG 


ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

PROCESS  INPUT  OR  TIMER  RUNOUT 

PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

PROCESS  RESPONSE  TO  LINE  BID 

TRANSMIT  A  LINE  BID  MESSAGE 

PROCESS  MESSAGE  FROM  OTHER  COMM 

SET  APPROPRIATE  TIME  INTERVAL  AND  START 

TIMER 

WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 
TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


XMTBLK 

ACTSES 

ALINPS 

ALRESP 

COMVH 

COM  VI 

EXOUDA 

IDLINE 

INILAN 

INTVH 

I  NT  VI 

KPLXMT 


ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 

PROCESS  INPUT  OR  TIMER  RUNOUT 

INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

INITIALIZE  COMM  VARIABLES 

INITIALIZE  COMM  VARIABLES 

PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
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COMM  Where- inc lude-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


LBRESP  PROCESS  RESPONSE  TO  LINE  BID 
LINBID  TRANSMIT  A  LINE  BID  MESSAGE 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 
POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

TRCVH2  TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

TRMLAN  RELEASE  THE  PORT  TO  THE  LAN 

UDXSQN  UPDATE  TRANSMIT  SEQUENCE  NUMBER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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COMM  Where-external -routine-used  List 


System 

Module 


Module 

Name 


Module 

Purpose 


CNLTIM 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 

KPLXMT  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


DELMBX 

COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


ERRPRO 

ACTSES 

ALINPS 

ALRESP 

CNLLAN 

CNLTRM 

COMVH 

COM  VI 

DACSES 

EXOUDA 

GETLAN 

GOUTMS 

IDLINE 

INITRM 

INTVH 

I  NT  VI 

KPLXMT 

LBRESP 

LINBID 

PARITY 

PINPMS 


ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 
WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 
RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
CANCEL  TERMINAL  10 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
REPORT  A  SESSION  FAILURE  TO  NTM 
EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 
GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 

GET  A  MESSAGE  FROM  NTM 
PROCESS  INPUT  OR  TIMER  RUNOUT 
INITIALIZE  THE  TERMINAL  LINE 
INITIALIZE  COMM  VARIABLES 
INITIALIZE  COMM  VARIABLES 
PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
PROCESS  RESPONSE  TO  LINE  BID 
TRANSMIT  A  LINE  BID  MESSAGE 
SET  CHANNEL  TO  EVEN  PARITY 
PROCESS  MESSAGE  FROM  OTHER  COMM 
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COMM  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


POUTMS  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT 
BUFFER 

PURGE  CLEAR  THE  TYPE  AHEAD  BUFFER 

RCV5H  RECEIVE  5  CURSORS  FROM  THE  IBM 

RCVIBM  READ  TERMINAL  LINE  FROM  PROTOCOL 
CONVERTER  *  * 

RCVLAN  RECEIVE  FROM  A  LAN  TERMINAL  LINE 
RCVTRM  READ  TERMINAL  LINE  WITH  EVENT  FLAG 

REPTER  REPORT  RECOVERABLE  ERROR  TO  NTM 
SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 
NTM 

SETSPD  INITIALIZE  THE  TERMINAL  SPEED 

STRTIM  SET  APPROPRIATE  TIME  INTERVAL  AND  START 
TIMER 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 
XMTLAN  TRANSMIT  TO  A  LAN  TERMINAL  LINE 
XMTMSG  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 
XMTTRM  TRANSMIT  TO  THE  TERMINAL  LINE 


FREVTF 

CNLLAN  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
GETLAN  GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL 
LINE 


GETMSG 

GOUTMS  GET  A  MESSAGE  FROM  NTM 


INICOM 

INTVH  INITIALIZE  COMM  VARIABLES 
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| 

COMM 

Vher e-external -routine-used  List 

4V 

System 

Module 

Module 

Module 

Mane 

Purpose 

V 

INTV  I 

INITIALIZE  COMM  VARIABLES 

v. 

$ 

:S! 

INSTNC 

SCTLMS 

REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 

& 

NTM 

v! 

LIBJGET 

- 

EF 

•:! 

RCVIBM 

READ  TERMINAL  LINE  FROM  PROTOCOL 

$ 

CONVERTER  ** 

.V 

RCVTRM 

READ  TERMINAL  LINE  WITH  EVENT  FLAG 

1 

RCVMSG 

GOUTMS 

GET  A  MESSAGE  FROM  NTM 

, 

INTVH 

INITIALIZE  COMM  VARIABLES 

INTVI 

INITIALIZE  COMM  VARIABLES 

rV 

.*s 

•V 

<  f. 

■!<: 

RELEVB 

COMVH 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

1 

COM  VI 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

1 

SETTIM 

PINPMS 

PROCESS  MESSAGE  FROM  OTHER  COMM 

i’ 

1 

STRTIM 

SET  APPROPRIATE  TIME  INTERVAL  AND  START 

TIMER 

$ 

SKDMSG 

•.‘I* 

•* 

PINPMS 

PROCESS  MESSAGE  FROM  OTHER  COMM 

i:5 
.*  ■ 
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COMM  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SCTLMS  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 
NTM 


SYS $ ALLOC 

INITRM  INITIALIZE  THE  TERMINAL  LINE 


SYSJASSIGN 

INITRM  INITIALIZE  THE  TERMINAL  LINE 


SYS $ CANCEL 

CNLTRM  CANCEL  TERMINAL  10 


SYSSQIO 

RCV5H  RECEIVE  5  CURSORS  FROM  THE  IBM 

RCVIBM  READ  TERMINAL  LINE  FROM  PROTOCOL 
CONVERTER  ** 

RCVTRM  READ  TERMINAL  LINE  WITH  EVENT  FLAG 


SYSSQIOW 

PARITY  SET  CHANNEL  TO  EVEN  PARITY 

PURGE  CLEAR  THE  TYPE  AHEAD  BUFFER 

SETCHR  SET  TERMINAL  CHARACTERISTICS 
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COMM  Where-external-rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


SETS PD  INITIALIZE  THE  TERMINAL  SPEED 

XMTTRM  TRANSMIT  TO  THE  TERMINAL  LINE 


SYSSSETPRI 

RCVIBM  READ  TERMINAL  LINE  FROM  PROTOCOL 

CONVERTER  ** 

RCVTRM  READ  TERMINAL  LINE  WITH  EVENT  FLAG 

XMTTRM  TRANSMIT  TO  THE  TERMINAL  LINE 


TRMNAX 

COMVH  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


WAIT01 

ACTSES  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 
PINPMS  PROCESS  MESSAGE  FROM  OTHER  COMM 


WAIT02 

ALINPS  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

LBRESP  PROCESS  RESPONSE  TO  LINE  BID 

W1RESP  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


WAIT03 

IDLINE  PROCESS  INPUT  OR  TIMER  RUNOUT 


WWW* 
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COMM  Where -external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 
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3.10.7  Main  Program  Parts  List 


The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  “well-defined 
module”  appears  by  the  module  name,  if  not  it  is  an  “external 
"routine*.  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 
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COMM  Main  Program  Parts 

Maiz>  Pga  Module 
Naae  Name 


COMVH  Purpose 

ACTSES 

ALINPS 

ALRESP 

CNLLAM 

CNLTIM 

CNLTRM 

DACSES 

DELMBX 

ERRPRO 

EXOUDA 

FREVTF 

GETLAN 

GETMSG 

GOUTMS 

IDLINE 

INIOOM 

INILAK 

INITRM 

INSTNC 

INTVH 

KLCLRC 

KM I NO A 

KPLXMT 

LBRESP 

LIBSGETEF 

LINBID 

PARITY 

PINPMS 

POUTMS 

PURGE 

RCV5H 

RCVIBM 

RCVLAN 

RCVMSG 

RCVTRM 

RELEVB 

REPTER 

SCTLMS 


List 

Module 

Type 


- >MAIN  MODULE  FOR  COMMUNICATIONS 
SUBSYSTEM 

Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
External  routine 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
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COMM  Main  Program  Parts  List 


Main  Pgm 
Name 


Module 

Module 

Name 

Type 

SETCHR 

Well-defined  module 

SETS PD 

Well-defined  module 

SETTIM 

External  routine 

SNDMSG 

External  routine 

STRTIM 

Well-defined  module 

SYS $ ALLOC 

External  routine 

SYSSASSIGN 

External  routine 

STS $ CANCEL 

External  routine 

SYSSQIO 

External  routine 

SYSSQIOW 

External  routine 

SYSJSETPRI 

External  routine 

TRCVH1 

Well-defined  module 

TRCVH2 

Well-defined  module 

TRMLAN 

Well-defined  module 

TRMNAX 

External  routine 

UDRSQN 

Well-defined  module 

UDXSQN 

Well-defined  module 

W1RESP 

Well-defined  module 

WAIT01 

External  routine 

WAIT02 

External  routine 

WAIT03 

External  routine 

XMTLAN 

Well-defined  module 

XMTMSG 

Well-defined  module 

XMTTRM 

Well-defined  module 
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COMM  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


Purpose-- .MAIN  MODULE  FOR  COMMUNICATIONS 
SUBSYSTEM 


COM  VI 

ACTSES 
ALINPS 
ALRESP 
CNLLAN 
CNLTIM 
CNLTRM 
DACSES 
DELMBX 
ERRPRO 
EXOUDA 
FREVTF 
GETLAN 
GETMSG 
GOUTMS 
IDLINE 
INICOM 
INILAN 
INITRM 
INSTNC 
INTVI 
KLCLRC 
KMINDA 
KPLXMT 
LBRESP 
LIB$GET_EF 
LINBID 
PARITY 
PINPMS 
POUTMS 
PURGE 
RCV5H 
RCVIBM 
RCVLAN 
RCVMSG 
RCVTRM 
RELEVB 
REPTER 
SCTLMS 


Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Extern  1  routine 
External  routine 
Well-defined  module 
External  routine 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
Well -def i ned  modu 1 e 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
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COMM  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


SETCHR 

SETS PD 

SETTIM 

SNDMSG 

STRTIM 

SYS $ ALLOC 

SYSSASSIGN 

SYSSCANCEL 

SYSSQIO 

SYSSQIOW 

SYSSSETPRI 

TRCVH1 

TRCVH2 

TRMLAN 

TRMNAX 

UDRSQN 

UDXSQN 

W1RESP 

WAIT01 

WAIT02 

WAIT03 

XMTLAN 

XMTMSG 

XMTTRM 


Module 

Type 


Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 


Name  of  program  Module. 


PURPOSE : 


Purpose  of  Module  as  detailed  in  the 
source  code . 


LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 


r? 


c 


Cl/S-l  Workbench  C) 
VAX- 11  COBOL 


MODULE  TYPE: 


Whether  a  Program,  Subroutine,  or 
Function . 


SOURCE  FILE: 

SOURCE  FILE  TYPE: 


HOST: 


SUBSYSTEM : 


Name  of  Source  File  from  file 
specification . 

Source  File  Extension  from  file 
specification . 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
host-independent . 

IISS  sub-system  this  file  resides  in. 


SUBDIRECTORY: 


Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 

DESCRIPTION:  A  description  of  the  module  as  otained 
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V; 


ARGUMENTS : 


INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY 


from  the  source  code. 

The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Function. 

A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

The  documented  routines  which  call 
this  module,  if  any. 


USED  IN  MAIN  PROGRAM ( S ) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabet ical ly  according 
to  Module  Name. 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


ACTSES 

ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

VAX- 11  COBOL 

SUBROUTINE 

ACTSES 

•  COB 

COMM 

COMM 


DESCRIPTION : 


-  ACTSES  WAITS  TO  RECEIVE  A  MESSAGE  FROM  NTM. 
IF  THE  MESSAGE  IS  START  A  SESSION', 

ACTSES  INITIATES  THE  PROCEDURE  TO  HANDLE 
THE  LOCAL  AREA  NETWORK  COMMUNICATIONS. 

IF  THE  MESSAGE  IS  TERMINATE  THE  SESSION', 
THAT  REQUEST  IS  NOTED  HERE  BUT  PROCESSED 
BY  THE  MAIN  MODULE.  ANY  OTHER  REQUEST 
FROM  NTM  IS  CONSIDERED  AN  ERROR. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE 
ARE  FATAL  TO  COMM. 


ARGUMENTS : 


LAN-EVENT-BLOCK  -  RECRD 
NTM -RCV-EVENT- BLOCK  -  DSPLY  [X(2032>] 
TIMER -EVENT -BLOCK  -  RECRD 
NTM-SEND-EVENT-BLOCK-H  -  DSPLY  [X(2032)] 
XMIT-BLOCK  -  RECRD 
RCV- BLOCK  -  RECRD 

INPUT-MAILBOX-NAME  -  DSPLY  tX(14)] 

TARGET -MAILBOX -NAME -H  -  DSPLY  [X(14)] 

FLAGS  -  RECRD 

NTM -OUTPUT - BLOCK  -  RECRD 

NTM-INPUT-MSG-POSITION  -  DSPLY  [9(4)] 

NTM-INPUT-MSG  -  RECRD 

RET-STATUS  -  DSPLY  [X(5)3 
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INCLUDE  FILES: 


OOMOON 

ERNSTS 

CHESTS 

LANEVB 

NRCVEB 

TIMEVB 

NHSNEB 

XMTBLK 

RCVBLK 

COMFLG 

NTMOUB 

NTMHDR 

NTMINB 

RPTERR 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS . INC  —  IISS  ERROR  CODES 
CHESTS. INC  —  CHECK  STATUS 
LANEVB. INC  --  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 

TIMEVB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

COMFLG  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

NTMHDR  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WAIT01 

GOUTMS  -  GET  A  MESSAGE  FROM  NTM 

XMTMSG  -  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

W1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

REPTER  -  REPORT  RECOVERABLE  ERROR  TO  NTM 
ERRPRO 


CALLED  DIRECTLY  BY: 


OOMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ALINPS 

WAIT  FOR  INPUT  FROM 

VAX- 11  COBOL 

SUBROUTINE 

ALINPS 

.COB 

COMM 

COMM 


LAN  OR  TIMER  RUNOUT 


-  ALINPS  WAITS  FOR  EITHER  THE  TIMER  TO  RUN  OUT 
OR  FOR  A  MESSAGE  FROM  THE  COMM  ON  THE  OTHER 
COMPUTER.  IF  THE  TIMER  RUNS  OUT,  ALINPS  CANCELS 
THE  OUTSTANDING  RECEIVE  ON  THE  LAN  PORT.  IF  COMM 
IS  MASTER.  ALINPS  CAUSES  THE  ORIGINAL  MESSAGE  TO 
BE  RETRANSMITTED.  IF  COMM  IS  SLAVE  AND  THERE 
IS  DATA  TO  BE  SENT  TO  THE  COMM  ON  THE  OTHER 
COMPUTER,  ALINPS  SETS  THE  RETRY  COUNT  TO  CAUSE 
THE  SESSION  TO  BE  TERMINATED.  IF  THERE  IS  NO 
DATA  TO  BE  SENT,  ALINPS  CHANGES  THE  STATE  OF 
COMM  TO  SESSION  ACTIVE,  LINE  IDLE. 

IF  ALINPS  RECEIVES  A  MESSAGE  FROM  THE  COMM 
ON  THE  OTHER  COMPUTER,  IT  CALLS  ALRESP  TO 
SEND  A  RESPONSE. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


LAN -EVENT -BLOCK  -  RECRD 

NTM-RCV- EVENT -BLOCK  -  DSPLY  [X(2032)3 

TIMER-EVENT-BLOCK  -  RECRD 

NTM - SEND -EVENT- BLOCK -H  -  DSPLY  [X(2032>] 

NTM- SEND- EVENT -BLOCK -L  -  DSPLY  [X(2032)] 

XM IT -BLOCK  -  RECRD 
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RCV- BLOCK  .  RE CRD 
INPOT-MAILBOX-NAME  «=  DSPLY  [X(14>] 
TARGET -MAILBOX-NAME-H  -  DSPLY  [X( 14)] 
TARGET-MAILBOX-NAME -L  -  DSPLY  [X(14)] 
FLAGS  -  RE CRD 
NTM-OOTPOT-BLOCK  -  RE CRD 
NTM- INPUT-MSG- POS ITION  -  DSPLY  [9(4) ] 
NTM- INPUT-MSG  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


COMCON 

ERRSTS 

CHKSTS 

LANEVB 

NRCVEB 

TIMEVB 

NHSNEB 

NLSNEB 

XMTBLK 

RCVBLK 

COMFLG 

NTMOUB 

NTMINB 

RPTERR 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS. INC  —  IISS  ERROR  CODES 
CHKSTS. INC  —  CHECK  STATUS 
LANEVB. INC  —  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 

TIMEVB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

NLSNEB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

COMFLG  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WAIT02 

CNLTIM 

GETLAN 

ALRESP 

CNLLAN 

XMTMSG 

RCVLAN 

REPTER 

ERRPRO 


GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL  LINE 
RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 
RECEIVE  FROM  A  LAN  TERMINAL  LINE 
REPORT  RECOVERABLE  ERROR  TO  NTM 


CALLED  DIRECTLY  BY: 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


ALRESP 

RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

VAX- 11  COBOL 

SUBROUTINE 

ALRESP 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  ALRESP  CHECKS  FIRST  FOR  AN  END  OF  TRANSMISSION 
OR  LINE  BID  MESSAGE  FROM  COMM  ON  THE  OTHER 
COMPUTER.  IF  THE  MESSAGE  IS  EITHER  EOT 
OR  LINE  BID,  ALRESP  CHANGES  THE  STATE  OF 
COMM  TO  SESSION  ACTIVE.  LINE  IDLE. 

IF  THE  MESSAGE  IS  NEITHER,  ALRESP 
VALIDATES  THE  INCOMING  MESSAGE.  IF  COMM 
HAD  SENT  A  MESSAGE  TO  COMM  ON  THE  OTHER  COMPUTER, 
ALRESP  CHECKS  THAT  IT  WAS  RECEIVED.  IF  IT  WAS 
NOT,  THE  MESSAGE  IS  RETRANSMITTED.  IF  IT  WAS, 

THE  NEXT  BLOCK  OF  DATA  IS  SENT  IF  THERE  IS  ONE. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


LAN -EVENT -BLOCK  -  RECRD 

NTM-RCV-EVENT-3L0CK  -  DSPLY  [X(2032>] 

TIMER -EVENT -BLOCK  *  RECRD 

NTM -SEND -EVENT- BLOCK -H  -  DSPLY  [X(2032)] 

NTM-SEND-EVENT-BLOCK-L  -  DSPLY  [X(2032)] 

XM IT -BLOCK  -  RECRD 

RCV- BLOCK  -  RECRD 

INPUT-MAILBOX-NAME  -  DSPLY  [X(14)] 
TARGET-MAILBOX-NAME-H  -  DSPLY  [X(14)J 
TARGET -MAILBOX -NAME -L  -  DSPLY  [X(14>] 
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FLAGS  -  RE CRD 

NTM -OUTPUT-BLOCK  -  RE CRD 

NTM-INPUT-MSG-POSITION  -  DSPLY  [9(4)] 

NTM- INPUT -MSG  -  RE CRD 

RET-STATUS  -  DSPLY  [X( 5) ] 


INCLUDE  FILES: 


COMCON 

CHKSTS 

ERNSTS 

LANEVB 

NRCVEB 

TIMEVB 

NHSNEB 

NLSNEB 

XMTBLK 

RCVBLK 

OOMFLG 

NTMOUB 

NTMINB 

RPTERR 

ERRPRO 


COMCON  -  INCLUDE  FILE 
CHKSTS. INC  —  CHECK  STATUS 
ERRSTS . INC  —  IISS  ERROR  CODES 
LANEVB. INC  —  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 

TIMEVB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

NLSNEB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

OOMFLG  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

•»**  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RCVLAN 

TRCVH2 

PINPMS 

POUTMS 

UDXSQN 

KPLXMT 

REPTER 

ERRPRO 


RECEIVE  FROM  A  LAN  TERMINAL  LINE 
TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 
PROCESS  MESSAGE  FROM  OTHER  COMM 

MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT  BUFFER 
UPDATE  TRANSMIT  SEQUENCE  NUMBER 
PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 
REPORT  RECOVERABLE  ERROR  TO  NTM 


CALLED  DIRECTLY  BY: 


ALINPS  -  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 


USED  IN  MAIN  PROGRAM ( S ) : 
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OOMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME:  CNLLAN 

PURPOSE:  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE :  CNLLAN 

SOURCE  FILE  TYPE:  .COB 

HOST:  VAX 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION: 


CANCEL  AN  OUTSTANDING  LAN  RECEIVE  REQUEST. 


ARGUMENTS : 


RCV- BLOCK  -  RECRD 

LAN -EVENT -BLOCK  =  RECRD 

RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CNLTRM  -  CANCEL  TERMINAL  10 

FREVTF 

ERRPRO 
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ALINPS  -  WAIT  FOR  INPOT  FROM  LAN  OR  TIMER  RUNOUT 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 

W1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME :  CNLTRM 

PURPOSE:  CANCEL  TERMINAL  10 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  CNLTRM 

SOURCE  FILE  TYPE:  .FOR 

HOST:  VAX 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION: 


CANCEL  A  RECEIVE  TO  A  TERMINAL  LINE 


ARGUMENTS : 


CHANNL  -  1*2 

-  TERMINAL  CHANNEL  NUMBER 
RSTATS  «=  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERR  PRO 
SYSJCANCEL 


CALLED  DIRECTLY  BY: 


CNLLAN  -  CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH 


MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Docunentat i on 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


COMVH 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

VAX- 11  COBOL 

PROGRAM 

COMVH 

-COB 

VAX 

COMM 

COMM 


DESCRIPTION: 


-  COMM  IS  ALWAYS  IN  ONE  OF  FOUR  STATES. 

1 .  SESSION  INACTIVE  -  COMM  IS  EXECUTING  BUT 
IT  HAS  NOT  ESTABLISHED  COMMUNICATIONS 

WITH  THE  NTM  YET. 

2.  SESSION  ACTIVE,  LINE  IDLE  -  COMM  AND  NTM 
HAVE  ESTABLISHED  COMMUNICATIONS  BUT  NTM 
HAS  NO  MESSAGES  TO  SEND  AND  COMM  IS  NOT 
RECEIVING  ANY  MESSAGES  FROM  THE  COMM  ON 
THE  OTHER  COMPUTER. 

3.  SESSION  ACTIVE,  LINE  BID  -  NTM  HAS  REQUESTED 
THAT  A  MESSAGE  BE  SENT  ACROSS  THE  LOCAL 

AREA  NETWORK  TO  THE  OTHER  COMPUTER  AND 
COMM  IS  REQUESTING  PERMISSION  FROM  THE 
COMM  ON  THE  OTHER  COMPUTER  TO  BECOME 
MASTER  OF  THE  LAN  LINE. 

4.  SESSION  ACTIVE,  LINE  ACTIVE  -  COMM  IS 
RECEIVING  A  MESSAGE  FROM  THE  COMM  ON 
THE  OTHER  COMPUTER  AND  MUST  SEND  IT 

TO  THE  NTM  AFTER  REASSEMBLY,  IF 
REQUIRED,  IS  DONE;  OR,  COMM  IS  SENDING 
A  MESSAGE  TO  THE  COMM  ON  THE  OTHER 
COMPUTER  FOR  NTM. 

THE  MAIN  MODULE  LOOPS  FOREVER  DETERMINING  THE 
STATE  OF  COMM  AND  PERFORMING  THE  REQUIRED 
PROCESSING.  FOREVER  ENDS  IF  AN  ERROR  OCCURS 
OR  IF  NTM  REQUESTS  COMM  TO  TERMINATE, 

AT  WHICH  TIME  COMM  SHUTS  ITSELF  DOWN. 

IF  COMM  IS  EXPERIENCING  DIFFICULTIES  GETTING 
SUCCESSFUL  TRANSMISSION  RESPONSES  FROM  THE 
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COMM  ON  THE  OTHER  COMPUTER.  IT  WILL  PLACE 
ITSELF  IN  THE  SESSION  INACTIVE  STATE. 


INCLUDE  FILES: 


COMCON 

LANEVB 

NRCVEB 

NLSNEB 

NHSNEB 

TIMEVB 

CHKSTS 

COMFLG 

NTMINB 

NTMOUB 

XMTBLK 

RCVBLK 

ERRPRO 


COMCON  -  INCLUDE  FILE 

LANEVB. INC  —  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 
NLSNEB  -  INCLUDE  FILE 
NHSNEB  -  INCLUDE  FILE 

TIMEVB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

CHKSTS. INC  —  CHECK  STATUS 

COMFLG  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INTVH 

DACSES 

ALINPS 

LBRESP 

IDLINE 

ACTSES 

DELMBX 

RELEVB 

TRMLAN 

TRMNAX 

ERRPRO 


INITIALIZE  COMM  VARIABLES 

REPORT  A  SESSION  FAILURE  TO  NTM 

WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

PROCESS  RESPONSE  TO  LINE  BID 

PROCESS  INPUT  OR  TIMER  RUNOUT 

ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 


RELEASE  THE  PORT  TO  THE  LAN 
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COMM  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


COM  VI 

MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
VAX- 11  COBOL 
PROGRAM 
COM VI 


.COB 


HOST :  VAX 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  COMM  IS  ALWAYS  IN  ONE  OF  FOUR  STATES. 

1.  SESSION  INACTIVE  -  COMM  IS  EXECUTING  BUT 
IT  HAS  NOT  ESTABLISHED  COMMUNICATIONS 

FITH  THE  NTM  YET. 

2.  SESSION  ACTIVE.  LINE  IDLE  -  COMM  AND  NTM 
HAVE  ESTABLISHED  COMMUNICATIONS  BUT  NTM 
HAS  NO  MESSAGES  TO  SEND  AND  COMM  IS  NOT 
RECEIVING  ANY  MESSAGES  FROM  THE  COMM  ON 
THE  OTHER  COMPUTER. 

3.  SESSION  ACTIVE.  LINE  BID  -  NTM  HAS  REQUESTED 
THAT  A  MESSAGE  BE  SENT  ACROSS  THE  LOCAL 

AREA  NETWORK  TO  THE  OTHER  COMPUTER  AND 
COMM  IS  REQUESTING  PERMISSION  FROM  THE 
COMM  ON  THE  OTHER  COMPUTER  TO  BECOME 
MASTER  OF  THE  LAN  LINE. 

4.  SESSION  ACTIVE,  LINE  ACTIVE  -  COMM  IS 
RECEIVING  A  MESSAGE  FROM  THE  COMM  ON 
THE  OTHER  COMPUTER  AND  MUST  SEND  IT 

TO  THE  NTM  AFTER  REASSEMBLY,  IF 
REQUIRED.  IS  DONE;  OR.  COMM  IS  SENDING 
A  MESSAGE  TO  THE  COMM  ON  THE  OTHER 
COMPUTER  FOR  NTM. 

THE  MAIN  MODULE  LOOPS  FOREVER  DETERMINING  THE 
STATE  OF  COMM  AND  PERFORMING  THE  REQUIRED 
PROCESSING.  FOREVER  ENDS  IF  AN  ERROR  OCCURS 
OR  IF  NTM  REQUESTS  COMM  TO  TERMINATE. 

AT  WHICH  TIME  COMM  SHUTS  ITSELF  DOWN. 

IF  COMM  IS  EXPERIENCING  DIFFICULTIES  GETTING 
SUCCESSFUL  TRANSMISSION  RESPONSES  FROM  THE 
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COMM  ON  THE  OTHER  COMPUTER,  IT  WILL  PLACE 
ITSELF  IN  THE  SESSION  INACTIVE  STATE. 


INCLUDE  FILES: 


GOMCON  -  COMCON  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  —  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

NRCVEB  -  NRCVEB  -  INCLUDE  FILE 

NLSNEB  -  NLSNEB  -  INCLUDE  FILE 

NHSNEB  -  NHSNEB  -  INCLUDE  FILE 

TIMEVB  -  TIMEVB . INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

CHKSTS  -  CHKSTS . INC  —  CHECK  STATUS 

GOMFLG  -  COMFLG  -  INCLUDE  FILE 

NTMINB  -  NTMINB  -  INCLUDE  FILE 

NTMOUB  -  NTMOUB  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INTVI 

DACSES 

ALINPS 

LBRESP 

IDLINE 

ACTSES 

DELMBX 

RELEVB 

TRMLAN 

TRMNAX 

ERRPRO 


INITIALIZE  COMM  VARIABLES 

REPORT  A  SESSION  FAILURE  TO  NTM 

WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

PROCESS  RESPONSE  TO  LINE  BID 

PROCESS  INPUT  OR  TIMER  RUNOUT 

ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 


RELEASE  THE  PORT  TO  THE  LAN 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


DACSES 

REPORT  A  SESSION  FAILURE  TO  NTM 

VAX- 11  COBOL 

SUBROUTINE 

DACSES 

-COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  DACSES  SETS  THE  FLAGS  TO  INDICATE  THAT 
COMM  IS  INACTIVE  AND  HAS  COMPLETED  A  SHUT 
DOWN.  IT  ALSO  SENDS  A  CONTROL  MESSAGE 
TO  NTM. 


ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


NTM -SEND- EVENT -BIK)CK-H  «  DSPLY  [X(2032)] 
TARGET-MAILBOX-NAME-H  -  DSPLY  [X(14)] 
FLAGS  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)J 


INCLUDE  FILES: 


COMCON 

ERRSTS 

CHKSTS 

NHSNEB 

COMFLG 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS. INC  --  IISS  ERROR  CODES 
CHKSTS. INC  --  CHECK  STATUS 
NHSNEB  -  INCLUDE  FILE 
COMFLG  -  INCLUDE  FILE 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 
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SCTLMS  -  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO  NTM 

ERRPRO 


CALLED  DIRECTLY  BY: 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
GOMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


EXOUDA 

EXPAND  NTM  DATA  IF  CONTROL  CHARS  OR  BINARY 

VAX- 11  COBOL 

SUBROUTINE 

EXOUDA 

.COB 

VAX 

COMM  ‘ 

COMM 


-  EXOUDA  MOVES  THE  MESSAGE  RECEIVED  FROM  THE 
NTM  TO  THE  DATA  PORTION  OF  THE  OUTPUT  BUFFER 
IN  PREPARATION  FOR  TRANSMISSION  ACROSS  THE 
LAN  TO  ANOTHER  COMM.  THE  NTM  HEADER  IS 
MOVED  EXACTLY  AST  IT  IS.  THE  MESSAGE 
PORTION  IS  HANDLED  DIFFERENTLY  DEPENDING 
UPON  ITS  TYPE.  IF  THE  MESSAGE  TYPE 
IS  NATIVE,  EXOUDA  SEARCHES  THE  MESSAGE  FOR 
CONTROL  CHARACTERS  AND  CONVERTS  THEM  TO  TWO 
CHARACTERS,  A  CHARACTER  THAT  INDICATES  TYPE 
OF  CONTROL  CHARACTER  FOLLOWED  BY  A 
TRANSMITTABLE  CHARACTER  THAT  IS  USED  AS  A 
CODE  TO  INDICATE  THE  ORIGINAL  CONTROL  CHARACTER. 
IF  THE  MESSAGE  TYPE  IS  BINARY,  ALL  THE  CHARACTERS 
ARE  TREATED  AS  IF  THEY  WERE  NOT  TRANSMITTABLE. 
EACH  CHARACTER  IS  DIVIDED  INTO  TWO  4-BIT 
NIBBLES.  THE  CHARACTER  EQUIVALENT  OF  THE  VALUE 
OF  EACH  NIBBLE  IS  STORED  IN  THE  OUTPUT  BUFFER. 
EXOUDA  SETS  THE  CONTROL  BYTE  IN  THE  HEADER  OF 
THE  COMM  OUTPUT  MESSAGE  TO  INDICATE  THE  TYPE 
OF  DATA  BEING  SENT  AND  WHETHER  THE  BLOCK  OF 
DATA  IS  COMPLETE. 


ARGUMENTS : 


NTM -OUTPUT - BLOCK  -  RECRD 
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XM IT -BLOCK  -  RECRD 
FLAGS  -  RECRD 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 
ASCII  -  ASCII-  INCLUDE  FILE 

NTMOUB  -  NTMOUB  -  INCLUDE  FILE 

NTMHDR  -  NTMHDR  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

GOMFLG  -  COMFLG  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


ERRPRO 


CALLED  DIRECTLY  BY: 


POUT MS  -  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT  BUFFER 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


GETLAN 

GET  A  MESSAGE  RECEIVED  FROM  A  LAN 

TERMINAL  LINE 

VAX- 11  COBOL 

SUBROUTINE 

GETLAN 

-COB 

VAX 

COMM 

COMM 


DESCRIPTION: 


GET  THE  MESSAGE  RECEIVED  FROM 
THE  TERMINAL.  AN  EVENT  FLAG 
HAS  INDICATED  THE  ARRIVAL  OF  THE  MSG. 


ARGUMENTS : 


RCV- BLOCK  -  RECRD 
LAN-EVENT-BLOCK  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  —  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FREVTF 

ERRPRO 
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CALLED  DIRECTLY  BY: 


ALINPS  -  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 

W1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


GOOTMS 

GET  A  MESSAGE  FROM  NTM 

VAX- 11  COBOL 

SUBROUTINE 

GOUTMS 

.COB 

COMM 

COMM 


-  GOUTMS  DETERMINES  IF  THERE  IS  A  MESSAGE 
FROM  NTM  IN  THE  MAILBOX.  IF  ONE  IS 
PRESENT.  IT  IS  MOVED  INTO  COMM  STORAGE  AND 
A  NEW  RECEIVE  IS  ISSUED  FOR  THE  NTM 
MAILBOX. 

EXCEPT  FOR  "MAILBOX  EMPTY".  ANY  BAD  STATUS 
CONDITION  IN  THIS  ROUTINE  IS  FATAL  TO  COMM. 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 

NTM  -  RC  V  -  EVENT  -  BLOCK  «=  DSPLY  [X(2032)l 
NTM -OUTPUT-BLOCK  -  RECRD 
RET-STATUS  =  DSPLY  [9(5)1 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

NRCVEB  -  NRCVEB  -  INCLUDE  FILE 

NTMOUB  -  NTMOUB  -  INCLUDE  FILE 

NTMHDR  -  NTMHDR  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


GETMSG 

RCVMSG 

ERRPRO 


CALLED  DIRECTLY  BY: 


ACTSES  -  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

POUTMS  -  MOVE  DATA  FROM  NTM  MAILBOX  TO  LAN  OUTPUT  BUFFER 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

OOMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


IDLINE 

PROCESS  INPUT  OR  TIMER  RUNOUT 

VAX- 11  COBOL 

SUBROUTINE 

IDLINE 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  IDLINE  FIRST  CHECKS  FOR  A  REQUEST  FROM 
NTM  TO  TERMINATE  THE  SESSION.  IF  THE 
REQUEST  HAS  BEEN  MADE,  IDLINE  CAUSES  THE 
SESSION  TO  END.  IF  NTM  HAS  NOT  MADE  THE 
REQUEST,  IDLINE  WAITS  FOR  THE  TIMER  TO  RUN 
OUT  OR  FOR  A  MESSAGE  FROM  EITHER  NTM  OR 
FROM  COMM  ON  THE  OTHER  COMPUTER.  IF  A  LINE 
BID  IS  RECEIVED  FROM  THE  OTHER  COMM,  A  POSITIVE 
ACKNOWLEDGEMENT  IS  RETURNED  AND  THE  STATE 
OF  COMM  IS  CHANGED  TO  SESSION  ACTIVE,  LINE 
ACTIVE.  IF  A  MESSAGE  IS  RECEIVED  FROM  NTM, 

A  LINE  BID  IS  SENT  TO  THE  COMM  ON  THE  OTHER 
COMPUTER . 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


LAN -EVENT -BLOCK  =  RECRD 

NTM - RC V - EVENT - BLOCK  =  DSPLY  [X(2032)] 

TIMER-EVENT-BLOCK  -  RECRD 

NTM  -  SEND- EVENT- BLOCK -H  ■=  DSPLY  [X(2032)] 

XM IT- BLOCK  -  RECRD 

RCV- BLOCK  =  RECRD 

INPUT-MAILBOX-NAME  -  DSPLY  [X(14)] 
TARGET- MAILBOX -NAME -H  =  DSFLY  [ X( 14 ) ] 
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FLAGS  «=  RECRD 

NTM -OUT PUT -BLOCK  =  RECRD 

NTM-INPUT-MSG-POSITION  *  DSPLY  [9(4)] 

NTM-INPUT-MSG  =  RECRD 

RET- STATUS  -  DSPLY  [X( 5 ) ] 


| 

INCLUDE  FILES : 


COMCON 

ERRSTS 

CHKSTS 

LANEVB 

NRCVEB 

TIMEVB 

NHSNEB 

XMTBLK 

RCVBLK 

COMFLG 

NTMOUB 

NTMHDR 

NTMINB 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS. INC  --  IISS  ERROR  CODES 
CHKSTS. INC  --  CHECK  STATUS 
LANEVB. INC  --  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 

TIMEVB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

COMFLG  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

NTMHDR  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CNLLAN 

DACSES 

WAIT03 

GETLAN 

XMTMSG 

CNLTIM 

RCVLAN 

GOUTMS 

LINBID 

ERRPRO 


CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 
REPORT  A  SESSION  FAILURE  TO  NTM 

GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL  LINE 
TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 
GET  A  MESSAGE  FROM  NTM 
TRANSMIT  A  LINE  BID  MESSAGE 


CALLED  DIRECTLY  BY: 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM ( S ) : 
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COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


INILAN 

INITIALIZE  THE  LAN 

VAX- 11  COBOL 

SUBROUTINE 

INILAN 

.COB 

VAX 

COMM 

COMM 


TERMINAL  INTERFACE 


INITIALIZE  THE  TERMINAL  INTERFACE  TO 
THE  LOCAL  AREA  NETWORK.  PLACE  THE 
CHANNEL  NUMBER  IN  THE  FIRST  TWO  BYTE 
OF  THE  RCV  AND  XMT  BLOCKS. 


ARGUMENTS : 


PORT -NAME  =  RECRD 
RCV -BLOCK  *  RECRD 
XMIT-BLOCK  =  RECRD 
LAN -EVENT-BLOCK  «  RECRD 
RET-STATUS  *  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 


ROUTINES  CALLED. 


I N I TRM  INITIALIZE  THE  TERMINAL  LINE 
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CALLED  DIRECTLY  BY: 


INTVH  -  INITIALIZE  COMM  VARIABLES 

INTVI  -  INITIALIZE  COMM  VARIABLES 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


INITRM 

INITIALIZE  THE  TERMINAL  LINE 
VAX- 11  FORTRAN 
SUBROUTINE 
INITRM 
-FOR 
VAX 
COMM 

COMM 


TO  ASSIGN  A  CHANNEL  TO  THE  TERMINAL 
ON  THE  LAN 


ARGUMENTS : 


TARGET 

PORTNM 

CHANNL 

RSTATS 


CHAR 

TARGET  COMPUTER  FLAG 
CHAR 

TERMINAL  PORT  NAME 
1*2 

CHANNEL  NUMBER 
CHAR 

RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS  INF  -  ••**  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO 

PARITY 

SET  CHANNEL  TO  EVEN  PARITY 

•  • 

PURGE 

CLEAR  THE  TYPE  AHEAD  BUFFER 

•  • 

SETCHR 

SET  TERMINAL  CHARACTERISTICS 

•  • 

SETSPD 

INITIALIZE  THE  TERMINAL  SPEED 

•  « 

SYSS  ALIjOC 

SYSSASSIGN 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 


INTVH 

INITIALIZE  COMM  VARIABLES 

VAX- 11  COBOL 

SUBROUTINE 

INTVH 

.COB 

VAX 

COMM 


DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  INTVH  INITIALIZES  THE  MAILBOX  AND  PORT 
INTERFACE  VARIABLES  AND  COMM  STORAGE. 


ARGUMENTS : 


NTM-RCV-EVENT-BLOCK  =  DSPLY  [X(2032>] 
LAN-EVENT-BLOCK  =  RECRD 
XMIT-BLOCK  -  RECRD 
RCV- BLOCK  «  RECRD 

INPUT-MAILBOX-NAME  =  DSPLY  [X(14)J 
T ARGET-M A I L BOX -NAME -H  -  DSPLY  [X(14>] 
TARGET-MAILBOX-NAME-L  -  DSPLY  [X(14)] 
FLAGS  =  RECRD 
NTM -OUT PUT - BLOCK  «  RECRD 
NTM-INPUT-MSG-POSITION  «  DSPLY  [9(4)] 
NTM- INPUT-MSG  -  RECRD 
PORT-NAME  -  DSPLY  [X(12)3 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


COMCON 

CHKSTS 

NRCVEB 

XMTBLK 

RCVBLK 


-  COMCON  -  INCLUDE  FILE 

-  CHKSTS. INC  --  CHECK  STATUS 

-  NRCVEB  -  INCLUDE  FILE 

-  XMTBLK  -  INCLUDE  FILE 

-  RCVBLK  -  INCLUDE  FILE 
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COMFLG  -  COMFLG  -  INCLUDE  FILE 

NTMOUB  -  NTMOUB  -  INCLUDE  FILE 

NTNINB  -  NTMINB  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  —  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INICOM 

RCVMSG 

INILAN  -  INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

ERRPRO 


CALLED  DIRECTLY  BY: 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM(S): 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


■ 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


INTVI 

INITIALIZE  COMM  VARIABLES 

VAX- 11  COBOL 

SUBROUTINE 

INTVI 

.COB 

VAX 

COMM 


DESCRIPTION: 


-  INTCM1  INITIALIZES  THE  MAILBOX  AND  PORT 
INTERFACE  VARIABLES  AND  COMM  STORAGE. 


ARGUMENTS : 


NTM-RCV-EVENT-BLOCK  -  DSPLY  [X(2032)l 
LAN -EVENT-BLOCK  =  RECRD 
XMIT-BLOCK  -  RECRD 
RCV- BLOCK  -  RECRD 

INPUT-MAILBOX-NAME  =  DSPLY  [X(14)J 

TARGET -MAILBOX -NAME -H  -  DSPLY  [X(14)] 

TARGET-MAILBOX-NAME-L  -  DSPLY  [X(14>] 

FLAGS  «  RECRD 

NTM -OUT PUT- BLOCK  -  RECRD 

NTM- INPUT-MSG-POSITION  -  DSPLY  [9(4)] 

NTM-INPUT-MSG  -  RECRD 

PORT-NAME  -  DSPLY  [X(12)] 

RET-STATUS  -  DSPLY  [ X( 5 ) ] 


INCLUDE  FILES: 


COMCON 

CHKSTS 

NRCVEB 

XMTBLK 

RCVBLK 


COMCON  -  INCLUDE  FILE 
CHKSTS. INC  --  CHECK  STATUS 
NRCVEB  -  INCLUDE  FILE 
XMTBLK  -  INCLUDE  FILE 
RCVBLK  -  INCLUDE  FILE 
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COMFLG  -  COMFLG  -  INCLUDE  FILE 

NTMOUB  -  NTKOOB  -  INCLUDE  FILE 

NTMINB  -  NTMINB  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  —  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE  * 


ROUTINES  CALLED: 


INICOM 

RCVMSG 

INILAN  -  INITIALIZE  THE  LAN  TERMINAL  INTERFACE 

ERRPRO 


CALLED  DIRECTLY  BY: 


COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM ( S ) : 


COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


KLCLRC 

CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 

VAX- 11  COBOL 

SUBROUTINE 

KLCLRC 

.COB 

VAX 

COMM 

COMM 


DESCRIPTION: 


-  KLCLRC  CALCULATES  THE  LONGITUDINAL  REDUNDANCY 
CHECK  BY  ADDING  ALL  THE  CHARACTERS  IN  THE  MESSAGE 
AND  THEN  SEPARATING  THAT  SUM  INTO  THREE  6-BYTE 
QUANTITIES.  THESE  THREE  QUANTITIES  BECOME 
INDEXES  INTO  A  TABLE  THAT  CONTAINS  CHARACTERS 
THAT  WILL  PASS  THROUGH  THE  HARDWARE 
UNALTERED.  THE  THREE  CHARACTERS  ARE 
RETURNED  TO  THE  CALLING  ROUTINE. 


ARGUMENTS : 


LRC- BLOCK  -  RECRD 
LRC -CHARS -ARRAY  -  RECRD 
FLAGS  -  RECRD 


INCLUDE  FILES: 


ASCII  -  ASCII-  INCLUDE  FILE 

COMFLG  -  COMFLG  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 


KPLXMT  -  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

PINPMS  -  PROCESS  MESSAGE  FROM  OTHER  COMM 
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USED  IN  MAIN  PROGRAM(S): 


COMVH 
COM  VI 


MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


KMINDA 

COMPRESS  THE  DATA 

VAX- 11  COBOL 

SUBROUTINE 

KMINDA 

-COB 

VAX 

COMM 

COMM 


IN  THE  RECEIVE  BUFFER 


-  KMINDA  FIRST  MOVES  THE  NTM  HEADER  PORTION 
OF  THE  MESSAGE  TO  THE  INPUT  BUFFER.  IT 
THEN  DETERMINES  WHETHER  THE  DATA  PART 
OF  THE  MESSAGE  FROM  THE  COMM  ON  THE  OTHER 
COMPUTER  IS  NATIVE  OR  BINARY.  IF  THE 
DATA  IS  NATIVE,  KMINDA  SEARCHES  IT  FOR 
THE  EXCLAMATION  ( ! )  CHARACTER .  THE  ! 

IS  DISCARDED  AND  THE  FOLLOWING  CHARACTER 
IS  CONVERTED  TO  A  CONTROL  CHARACTER  THAT  IS 
INSERTED  INTO  THE  MESSAGE  FOR  THE  NTM. 

IF  THE  DATA  IS  BINARY,  KMINDA  CONVERTS  TWO 
CONSECUTIVE  CHARACTERS  BACK  TO  THEIR  EQUIVALENT 
BINARY  VALUES  AND  COMBINES  THEM  INTO  ONE 
BYTE  THAT  IS  PUT  INTO  THE  MESSAGE  FOR  NTM. 


ARGUMENTS : 


RCV- BLOCK  =  RECRD 
NTM-INPUT-MSG  =  RECRD 

NTM- INPUT-MSG- POSIT ION  =  DSPLY  [9(4)] 
FLAGS  =  RECRD 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 
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CTLASC  -  CTLASC  -  INCLUDE  FILE 
RCVBLK  -  RCVBLK  -  INCLUDE  FILE 
COHFLG  -  COMFLG  -  INCLUDE  FILE 
NTMINB  -  NTMINB  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 


PINPHS  -  PROCESS  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM(S): 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation. 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


KPLXMT 

PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

VAX- 11  COBOL 

SUBROUTINE 

KPLXMT 

.COB 

COMM 

COMM 


-  KPLXMT  DETERMINES  IF  THE  MESSAGE  CONTAINS 
DATA.  IN  WHICH  CASE.  THE  LONGITUDINAL 
REDUNDANCY  CHECK  (LRC)  IS  APPENDED  TO  THE 
END  OF  THE  DATA;  OR  IF  THE  MESSAGE  IS  ONLY 
TO  INDICATE  AN  END  OF  TRANSMISSION  (EOT). 

(EOT  INDICATES  THAT  THERE  IS  NO  MORE  DATA  TO 
BE  SENT  AND  THAT  THE  COMM  ON  THIS  SIDE  IS 
NO  LONGER  MASTER  OF  THE  LAN  LINE . )  KPLMIT 
ADDS  THE  MESSAGE  TERMINATOR  CHARACTER 
(A  CARRIAGE  RETURN)  AND  CAUSES  THE  MESSAGE  TO 
BE  SEND  TO  THE  LAN. 

IF  THE  MESSAGE  IS  EOT,  KPLXMT  ALSO  CANCELS  THE 
TIMER. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE 
ARE  FATAL  TO  COMM. 


ARGUMENTS : 


XM IT- BLOCK  -  RECRD 
TIMER-EVENT-BLOCK  =  RECRD 
FLAGS  -  RECRD 
RCV- BLOCK  =  RECRD 
LAN -EVENT -BLOCK  =  RECRD 
RET-STATUS  «  DSPLY  [X(5)] 
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INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

TIMEVB  -  TIMEVB . INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

OOMFLG  -  COMFLG  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

LANEVB  -  LANE VB. INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


KLCLRC  -  CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 

XMTMSG  -  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

CNLTIM 
ERRPRO 


CALLED  DIRECTLY  BY: 


ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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OOMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


LBRESP 

PROCESS  RESPONSE  TO  LINE  BID 

VAX- 11  COBOL 

SUBROUTINE 

LBRESP 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  LBRESP  WAITS  FOR  THE  RESPONSE  TO  ITS 
LINE  BID  FROM  THE  COMM  ON  THE  OTHER  COMPUTER. 
IF  THE  RESPONSE  IS  INCORRECT  OR  IT  IS  NOT 
RECEIVED  WITHIN  THE  GIVEN  TIKE  INTERVAL,  THE 
FACT  IS  REPORTED  TO  NTM  AND  THE  LINE  BID  IS 
SEND  AGAIN.  IF  THE  RESPONSE  RECEIVED  IS 
CORRECT,  LBRESP  CHANGES  THE  STATE  OF  COMM  TO 
SESSION  ACTIVE.  LINE  ACTIVE  AND  CAUSES  THE 
PROCESSING  OF  MESSAGES  WITH  DATA  TO  BEGIN. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


LAN-EVENT-BLOCK  -  RECRD 
NTM-RCV -EVENT-BLOCK  =  DSPLY  [X(2032>] 
TIMER -EVENT -BLOCK  =  RECRD 
NTM-SEND-EVENT-BLOCK-H  =  DSPLY  [X(2032)l 
NTM-SEND-EVENT-BLOCK-L  =  DSPLY  [X(2032)] 
XMIT-BLOCK  -  RECRD 
RCV- BLOCK  *  RECRD 

INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 
TARGET-MAILBOX-NAME-H  -  DSPLY  [X(14>] 
TARGET-MAILBOX-NAME-L  -  DSPLY  C X( 14 ) ] 
FLAGS  =  RECRD 
NTM -OUTPUT -BLOCK  *  RECRD 
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tti 


NTM-INPUT-MSG- POSITION 
NTM-INPUT-MSG  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)] 


DSPLY  [9(4)] 


INCLUDE  FILES 

COMCON 

ERRSTS 

CHKSTS 

LANEVB 

NRCVEB 

TIMEVB 

NHSNEB 

NLSNEB 

XMTBLK 

RCVBLK 

COMFLG 

NTMOUB 

NTMINB 

RPTERR 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS. INC  —  IISS  ERROR  CODES 
CHXSTS. INC  —  CHECK  STATUS 
LANEVB. INC  --  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 
NRCVEB  -  INCLUDE  FILE 

TIMEVB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

NLSNEB  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

COMFLG  -  INCLUDE  FILE 

NTMOUB  -  INCLUDE  FILE 

NTMINB  -  INCLUDE  FILE 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WAIT02 

CNLTIM 

GETLAN 

ALRESP 

RCVLAN 

CNLLAN 

LINBID 

REPTER 

ERRPRO 


GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL  LINE 

RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 

CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 

TRANSMIT  A  LINE  BID  MESSAGE 

REPORT  RECOVERABLE  ERROR  TO  NTM 


CALLED  DIRECTLY  BY: 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM ( S ) : 

COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


LINBID 

TRANSMIT  A  LINE  BID  MESSAGE 

VAX- 11  COBOL 

SUBROUTINE 

LINBID 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  LINBID  REQUESTS  THAT  A  MESSAGE  BE  TRANSMITTED 
TO  THE  COMM  ON  THE  OTHER  SIDE.  THE  MESSAGE 
CONTAINS  A  CODE  INDICATING  THAT  THIS  COMM  WANTS 
TO  BE  MASTER  OF  THE  LINE  BECAUSE  IT  HAS  ONE  OR 
MORE  BLOCKS  OF  DATA  TO  TRANSMIT. 


ARGUMENTS : 


FLAGS  «  RECRD 

XM IT -BLOCK  -  RECRD 

RCV- BLOCK  «  RECRD 

LAN - EVENT - BLOCK  -  RECRD 

TIMER-EVENT-BLOCK  -  RECRD 

RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


COMCON 

CHKSTS 

COMFLG 

XMTBLK 

RCVBLK 

LANEVB 

TIMEVB 

ERRPRO 


COMCON  -  INCLUDE  FILE 
CHKSTS. INC  --  CHECK  STATUS 
COMFLG  -  INCLUDE  FILE 
XMTBLK  -  INCLUDE  FILE 
RCVBLK  -  INCLUDE  FILE 

LANEVB. INC  —  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 

TIMEVB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


XMTMSG 

ERRPRO 


-  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


CALLED  DIRECTLY  BY: 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 


USED  IN  MAIN  PROGRAM(S) : 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME :  PARITY 

PURPOSE:  SET  CHANNEL  TO  EVEN  PARITY 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE :  PARITY 

SOURCE  FILE  TYPE:  .FOR 

HOST :  VAX 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION: 


TO  SET  A  CHANNEL  TO  EVEN  PARITY 


ARGUMENTS : 


CHANNL  -  1*2 

-  CHANNEL  NUMBER 
RSTATS  -  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO 

SYSSQIOW 


CALLED  DIRECTLY  BY: 


INITRM  -  INITIALIZE  THE  TERMINAL  LINE  ** 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME:  PINPMS 

PURPOSE:  PROCESS  MESSAGE  FROM  OTHER  COMM 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  PINPMS 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION : 


-  PINPMS  CHECKS  THE  MESSAGE  FOR  TRANSMISSION 
ERRORS,  VALIDATES  THAT  THE  DATA  BLOCK  IS 
THE  ONE  EXPECTED,  AND  SENDS  THE  DATA  TO 
THE  NTM  MAILBOX.  IT  ALSO  FILLS  IN  THE 
RECEIVED  SEQUENCE  NUMBER  IN  THE  COMM  HEADER 
FOR  THE  NEXT  MESSAGE  TO  BE  TRANSMITTED. 


ARGUMENTS : 


RCV- BLOCK  =  RECRD 

NTM-SEND-EVENT-BLOCK-H  «=  DSPLY  [X(2032>] 
NTM -SEND -EVENT- BLOCK -L  -  DSPLY  [X(2032)] 
TARGET-MAILBOX-NAME-H  «  DSPLY  [X(14)J 
TARGET-MAILBOX-NAME-L  -  DSPLY  [X(14)] 
FLAGS  -  RECRD 
XMIT-BLOCK  =  RECRD 

NTM- INPUT-MSG- POSITION  =  DSPLY  [9(4)] 
NTM-INPUT-MSG  -  RECRD 
RET-STATUS  -  DSPLY  (X(5)] 


INCLUDE  FILES 


COMCON 

ERRSTS 

CHKSTS 

TIMEVB 


-  COMCON  -  INCLUDE  FILE 

-  ERRSTS. INC  --  IISS  ERROR  CODES 

-  CHKSTS. INC  --  CHECK  STATUS 

-  TIMEVB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 
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RCVBLK 

-  RCVBLK  - 

INCLUDE 

FILE 

NHSNEB 

-  NHSNEB  - 

INCLUDE 

FILE 

NLSNEB 

-  NLSNEB  - 

INCLUDE 

FILE 

COMFLG 

-  COMFLG  - 

INCLUDE 

FILE 

XMTBLK 

-  XMTBLK  - 

INCLUDE 

FILE 

NTMINB 

-  NTMINB  - 

INCLUDE 

FILE 

NTMHDR 

-  NTMHDR  - 

INCLUDE 

FILE 

RPTERR 

-  ****  PURPOSE  NOT 

FOUND  BY  STRIPPER 

ERRPRO 

-  PROCESS 

ERROR  INCLUDE  FILE 

ROUTINES  CALLED: 


KLCLRC  -  CALCULATE  LONGITUDINAL  REDUNDANCY  CHECK 

TRCVH1  -  TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 

KMINDA  -  COMPRESS  THE  DATA  IN  THE  RECEIVE  BUFFER 

SETTIM 
WAIT01 

UDRSQN  -  UPDATE  RECEIVE  SEQUENCE  NUMBER 

SNDMSG 

REPTER  -  REPORT  RECOVERABLE  ERROR  TO  NTM 
ERRPRO 


CALLED  DIRECTLY  BY: 


ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


POUT MS 

MOVE  DATA  FROM  NTM 
BUFFER 

VAX- 11  COBOL 
SUBROUTINE 
POUTMS 
.COB 

COMM 

COMM 


MAILBOX  TO  LAN  OUTPUT 


-  POUTMS  FIRST  DETERMINES  IF  THERE  IS  ANY  DATA 
REMAINING  FROM  THE  LAST  MESSAGE  RECEIVED  FROM 
NTM  TO  BE  SENT  TO  COMM  ON  THE  OTHER  COMPUTER. 

IF  THERE  IS.  POUTMS  CAUSES  IT  TO  BE  CHECKED 
FOR  BINARY  OR  CONTROL  CHARACTERS  AND  MOVED 
TO  THE  BUFFER  FOR  OUTPUT.  IF  NO  DATA  IS  LEFT, 
POUTMS  TRIES  TO  GET  THE  NEXT  MESSAGE  FROM 
NTM.  IF  THERE  IS  NO  MESSAGE,  POUTMS  RETURNS 
TO  THE  CALLING  ROUTINE.  IF  THERE  IS  DATA. 

IT  IS  CHECKED  FOR  BINARY  OR  CONTROL  CHARACTERS 
AND  MOVED  TO  THE  BUFFER  FOR  OUTPUT  TO  COMM  ON 
ON  THE  OTHER  COMPUTER.  IF  THE  MESSAGE  FROM 
NTM  IS  A  CONTROL  MESSAGE  TO  DEACTIVATE  THE 
SESSION,  POUTMS  SETS  THE  FLAG  TO  INDICATE  THAT. 
ANY  OTHER  TYPE  OF  MESSAGE  FROM  NTM  AT  THIS  TIME 
IS  ILLEGAL. 


ARGUMENTS : 


NTM -RCV- EVENT -BLOCK  =  DSPLY  [X(2032)] 

INPUT-MAILBOX-NAME  -  DSPLY  [X(14)] 

FLAGS  -  RECRD 

NTM -OUTPUT -BLOCK  -  RECRD 

XM IT- BLOCK  -  RECRD 

RET-STATUS  =  DSPLY  [X(5>] 
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INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

CHKSTS  -  CHESTS . INC  —  CHECK  STATUS 

NRCVEB  -  NRCVEB  -  INCLUDE  FILE 

COMFLG  -  COMFLG  -  INCLUDE  FILE 

NTMOUB  -  NTMOUB  -  INCLUDE  FILE 

NTMHDR  -  NTMHDR  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


EXOUDA  -  EXPAND  NTH  DATA  IF  CONTROL  CHARS  OR  BINARY 

GOUTMS  -  GET  A  MESSAGE  FROM  NTM 

ERRPRO 


CALLED  DIRECTLY  BY: 


ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


PURGE 

CLEAR  THE  TYPE  AHEAD  BUFFER 
VAX- 11  FORTRAN 
SUBROUTINE 
PURGE 
.FOR 
VAX 
COMM 

COMM 


DESCRIPTION : 

REMOVE  ALL  CHARACTERS  FROM  THE  TYPE  AHEAD  BUFFER 


ARGUMENTS : 

i 

CHANNL  = 

1*2 

CHANNEL  NUMBER 

ft 

RSTATS  = 

CHAR 

- 

RETURN  STATUS 

INCLUDE  FILES: 

ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 

ERRPRO 

SYSSQIOW 
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COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  rv»„ 

*  Docu*entation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  Typp 
SOURCE  FILE- 

SCE  = 


**wo  l  ; 

SUBSYSTEM 

subdirectory •  comm 

"“""O'1  ®0UP :  COMM 

OESCRIptiqjj  • 


RCV5H 

j£S?^  -  -  • 

NCV5H 

•FOR 

VAX 

COMM 


from  ^protocol  ^converter  characters 

ARGUMENTS : 

CHANNL  -  x  *2 

RST«S  S1BAL  ““Wtt  HUMBER 

RETURN  status 
INCLUDE  FILES: 

ERRSTsT^fT  ....  Dr 

PURPOSE  NOT  FOUND  BY  ^ 

Rntvrr„  BY  dipper 

ROUTINES  CALLED: 

ERRPRO 

SYSSQio 

CALLED  DIRECTLY  BY; 

XMTLAN  I~~~ 

-  TO  a  LAN  TERMIMAL  LIKE 


USED_  PROGRAMCS): 


3-97 


PS  620143100 
1  November  1985 


COMVH 
COM  VI 


MAIN  MODULE  FOR  COMMUNICATIONS 
MAIN  MODULE  FOR  COMMUNICATIONS 


SUBSYSTEM 

SUBSYSTEM 


r 


4 

4 

f 

! 


a 

* 


f 

4 

4 


\ 

V 

I 

i 

J 

! 

s 

i 

v 

V 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


RCVIBM 

READ  TERMINAL  LINE  FROM  PROTOCOL 
CONVERTER 
VAX- 11  FORTRAN 
SUBROUTINE 
RCVIBM 
.FOR 
VAX 
COMM 


DESCRIPTION: 


TO  ISSUE  A  RECEIVE  TO  A  TERMINAL  ON  THE  LAN 


ARGUMENTS : 


CHANNL  -  1*2 

-  TERMINAL  CHANNEL  NUMBER 

EVTFLG  =  1*2 

-  EVENT  FLAG 

EVTBLK  =  1*2  (*) 

-  EVENT  BLOCK 

RCVBLK  -  L* 1  (*) 

-  RECEIVE  BLOCK 

LENGTH  *  1*2 

-  RECEIVE  BUFFER  LENGTH 
RSTATS  -  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO 

LIBSGETEF 

SYSSQIO 
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SYSSSETPRI 

CALLED  DIRECTLY  BY: 

RCVLAN  -  RECEIVE  FROM  A  LAN  TERMINAL  LINE 

USED  IN  MAIN  PROGRAM(S) : 

COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


RCVLAN 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 

VAX- 11  COBOL 

SUBROUTINE 

RCVLAN 

.COB 

VAX 

COMM 

COMM 


RECEIVE  FROM  A  TERMINAL  LINE  AND 
CONTINUE  PROCESSING.  USE  AN 
EVENT  FLAG  TO  ISSUE  THE  READ. 


ARGUMENTS : 


RCV- BLOCK  -  RECRD 
EVENT-NUMBER  -  DSPLY  [99] 
LAN-EVENT-BLOCK  -  RECRD 
FLAGS  *  RECRD 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  —  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

COMFLG  -  COMFLG  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RCVIBM  -  READ  TERMINAL  LINE  FROM  PROTOCOL  CONVERTER  »* 
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RCVTRM  -  READ  TERMINAL  LINE  WITH  EVENT  FLAG 

ERRPRO 


CALLED  DIRECTLY  BY: 


ALINPS  -  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 

W1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 

XMTMSG  -  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


USED  IN  MAIN  PROGRAM(S): 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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PS  620143100 
1  November  1985 


OOMM  Module  Documentation 


MAKE: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


RCVTRM 

READ  TERMINAL  LINE  WITH  EVENT  FLAG 
VAX- 11  FORTRAN 
SUBROUTINE 
RCVTRM 
.FOR 
VAX 
COMM 

COMM 


TO  ISSUE  A  RECEIVE  TO  A  TERMINAL  ON  THE  LAN 


ARGUMENTS 

• 

CHANNL 

1*2 

- 

TERMINAL  CHANNEL  NUMBER 

EVTFLG 

1*2 

- 

EVENT  FLAG 

EVTBLK 

1*2  C) 

- 

EVENT  BLOCK 

RCVBLK 

L*  1  (*) 

- 

RECEIVE  BLOCK 

LENGTH 

1*2 

— 

RECEIVE  BUFFER  LENGTH 

RSTATS 

CHAR 

— 

RETURN  STATUS 

INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO 

LIBSGETEF 

SYSSQIO 

SYSSSETPRI 
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CALLED  DIRECTLY  BY: 


RCVLAN  -  RECEIVE  FROM  A  LAN  TERMINAL  LINE 


USED  IN  MAIN  PROGRAM(S) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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PS  620143100 
1  November  1985 


COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


REPTER 

REPORT  RECOVERABLE  ERROR  TO  NTM 

VAX- 11  COBOL 

SUBROUTINE 

REPTER 

.COB 

COMM 

COMM 


-  REPTER  SENDS  A  RECOVERABLE  ERROR  CODE 
TO  NTM  TO  BE  RECORDED  WITH  THE  SYSTEM 
STATISTICS  INFORMATION.  THE  CODES  ARE 
CONCERNED  WITH  THE  INABILITY  OF  COMM  TO 
TRANSMIT  OR  RECEIVE  MESSAGES  ON  THE  LOCAL 
AREA  NETWORK  PORT.  REPTER  ALSO  INCREMENTS 
THE  RETRY  COUNT. 


ARGUMENTS 


COMM-STATUS  *  DSPLY  [X(5)] 

FLAGS  -  RECRD 

NTM-SEND-EVENT-BLOCK-H  -  DSPLY  [X(2032)] 
TARGET-MA I LBOX -NAME -H  -  DSPLY  [X(7>] 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


ERRSTS 

COMCON 

CHKSTS 

NHSNEB 

COMFLG 


ERRPRO 


-  ERRSTS. INC  —  IISS  ERROR  CODES 

-  COMCON  -  INCLUDE  FILE 

-  CHKSTS. INC  —  CHECK  STATUS 

-  NHSNEB  -  INCLUDE  FILE 

-  COMFLG  -  INCLUDE  FILE 


-  PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


SCTLMS  -  REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO  NTH 

ERRPRO 


CALLED  DIRECTLY  BY: 


ACTSES  -  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  -  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
LBRESP  -  PROCESS  RESPONSE  TO  LINE  BID 
PINPMS  -  PROCESS  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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SV 

% 


OOMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


SCTLMS 

REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO 
NTM 

VAX- 11  COBOL 
SUBROUTINE 
SCTLMS 
.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  SCTLMS  SENDS  A  RECOVERABLE  ERROR  CODE 
OR  A  STATUS  MESSAGE  TO  NTM.  NTM  RECORDS 
THE  INFORMATION  WITH  THE  SYSTEM  STATISTICS. 


ARGUMENTS : 


NTM-SEND-EVENT-BLOCK-H  «  DSPLY  [X(2032>] 
TARGET-MAILBOX -NAME -H  -  DSPLY  [X(14>] 
CONTROL-MSG-TYPE  =  DSPLY  [X(2)] 

MSG-DATA  -  DSPLY  [X(5)] 

FLAGS  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)J 


INCLUDE  FILES: 


CANHDR 

CHKSTS 

NHSNEB 

COMFLG 

ERRPRO 


CHKSTS. INC  --  CHECK  STATUS 
CHKSTS. INC  --  CHECK  STATUS 
NHSNEB  -  INCLUDE  FILE 
COMFLG  -  INCLUDE  FILE 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INSTNC 


PS  620143100 
1  November  1985 


SNDMSG 

ERRPRO 


CALLED  DIRECTLY  BY: 


DACSES  -  REPORT  A  SESSION  FAILURE  TO  NTM 

REPTER  -  REPORT  RECOVERABLE  ERROR  TO  NTM 

V1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


USED  IN  MAIN  PROGRAM(S): 


OOMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


S  ETC  HR 

SET  TERMINAL  CHARACTERISTICS 
VAX- 11  FORTRAN 
SUBROUTINE 
S ETC HR 
•  FOR 
VAX 
COMM 

COMM 


DESCRIPTION: 


TO  SET  THE  CHARACTERISTICS  OF  A  VAX  TERMINAL  LINE 


ARGUMENTS : 


CHANNL  =  1*2 

-  CHANNEL  NUMBER 

CHR  =  1*4 

-  CHARACTERISTIC  TO  BE  SET 

STATE  =  1*4 

-  STATE  (  1  =  ON,  0  =  OFF  ) 
RSTATS  =  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

ROUTINES  CALLED: 

SYSSQIOW 

CALLED  DIRECTLY  BY: 

INITRM  -  INITIALIZE  THE  TERMINAL  LINE 
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USED  IN  MAIN  PROGRAM(S): 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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OOMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


SETS PD 

INITIALIZE  THE  TERMINAL  SPEED 
VAX-11  FORTRAN 
SUBROUTINE 
SETSPD 
.FOR 
VAX 
COMM 

COMM 


DESCRIPTION: 


TO  ASSIGN  A  SPEED  TO  THE  TERMINAL  CHANNEL 


ARGUMENTS : 


CHANNL 
SPEED  - 
RSTATS 


1*2 

CHANNEL  NUMBER 
1*4 

CHANNEL  SPEED 
CHAR 

RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO 

SYSJQIOW 


CALLED  DIRECTLY  BY: 


INITRM  -  INITIALIZE  THE  TERMINAL  LINE 


USED  IN  MAIN  PROGRAM ( S ) : 
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COMM  Module  Documentation 


NAME :  STRTIM 

PURPOSE:  SET  APPROPRIATE  TIME  INTERVAL  AND  START 

TIMER 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE :  STRTIM 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION : 


-  STRTIM  DETERMINES  THE  TIME  INTERVAL  BASED 
ON  THE  STATE  OF  COMM.  IT  THEN  INVOKES  THE 
TIMER  FOR  THAT  TIME  INTERVAL  AND  RETURNS  TO 
THE  CALLING  ROUTINE. 

ANY  BAD  STATUS  IN  THIS  ROUTINE  IS  FATAL  TO  COMM. 


ARGUMENTS : 


TIMER-EVENT-BLOCK  -  RECRD 

FLAGS  -  RECRD 

RET -STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

COMFLG  -  COMFLG  -  INCLUDE  FILE 

TIMEVB  -  TIMEVB . INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SETT I M 
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ERRPRO 

CALLED  DIRECTLY  BY: 

XMTMSG  -  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

USED  IN  MAIN  PROGRAM(S) : 

COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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1  November  1985 


COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


TRCVH1 

TEST  1ST  BYTE  IN  HEADER  OF  RECEIVED  MSG 

VAX- 11  COBOL 

SUBROUTINE 

TRCVH1 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  TRCVH1  CHECKS  THAT  THE  FIRST  BYTE  IN 
THE  HEADER  OF  THE  MESSAGE  RECEIVED  FROM 
COMM  ON  OTHER  COMPUTER  IS  EITHER  ZERO  OR  A 
SEQUENCE  NUMBER  INDICATING  THE  MESSAGE  NAS 
THE  FIRST  OR  THE  NEXT  ONE  IN  THE  SERIES. 

IN  OTHER  WORDS,  CRCVH1  CHECKS  THAT  THE  FIRST 
BYTE  CONTAINS  THE  EXPECTED  SEQUENCE  NUMBER  FOR 
THE  RECEIVED  MESSAGE. 


ARGUMENTS : 


RCV- BLOCK  -  RECRD 

RET- STATUS  -  DSPLY  [9(5)] 


INCLUDE  FILES: 


ERRSTS  -  ERRSTS . INC  —  IISS  ERROR  CODES 

COMCON  -  COMCON  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 


PINPMS 


PROCESS  MESSAGE  FROM  OTHER  COMM 
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USED  IN  MAIN  PROGRAM(S): 


OOMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


TRCVH2 

TEST  2ND  BYTE  IN  HEADER  OF  RECEIVED  MSG 

VAX- 11  COBOL 

SUBROUTINE 

TRCVH2 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  TRCVH2  VALIDATES  THAT  THE  SECOND  BYTE 
IN  THE  HEADER  OF  THE  MESSAGE  RECEIVED  FROM 
COMM  ON  THE  OTHER  COMPUTER  IS  EITHER  ZERO 
OR  THE  EXPECTED  SEQUENCE  NUMBER.  THE  SEQUENCE 
NUMBER  INDICATES  IF  THE  LAST  MESSAGE 
TRANSMITTED  FROM  THIS  SIDE  WAS  RECEIVED 
CORRECTLY  BY  THE  OTHER  SIDE. 


ARGUMENTS : 


RCV- BLOCK  -  RECRD 
XM IT -BLOCK  -  RECRD 
RET-STATUS  -  DSPLY  [9(5)] 


INCLUDE  FILES: 


ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

COMCON  -  COMCON  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 


ALRESP 


RESPOND  TO  MESSAGE  FROM  OTHER  COMM 
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USED  IN  MAIN  PROGRAM(S): 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Document at i on 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


TRMLAN 

RELEASE  THE  PORT  TO  THE 

VAX- 11  COBOL 

SUBROUTINE 

TRMLAN 

.COB 

VAX 

COMM 

COMM 


LAN 


DESCRIPTION: 


-  THE  IBM  NEEDS  A  SPECIAL  ROUTINE  TO 
REQUEST  VTAM  TO  RELEASE  THE  PORT. 

THIS  IS  A  DUMMY  ROUTINE  ON  THE  VAX  AND 
LEVEL  6. 


ARGUMENTS : 


PORT-NAME  -  DSPLY  [X(12)3 
RCV  BLOCK  - 
XMIT-BLOCK  -  RECRD 
LAN-EVENT-BLOCK  -  RECRD 
RET- STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 


CALLED  DIRECTLY  BY: 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 


USED  IN  MAIN  PROGRAM ( S ) : 
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COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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GOMM  Module  Documentation 


NAME :  UDRSQN 

PURPOSE:  UPDATE  RECEIVE  SEQUENCE  NUMBER 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE :  UDRSQN 

SOURCE  FILE  TYPE:  -COB 

HOST: 

SUBSYSTEM :  COMM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  COMM 

DESCRIPTION: 


-  UDRSQN  INCREMENTS  THE  RECEIVE  SEQUENCE  NUMBER. 
WHEN  THE  UPPER  LIMIT  IS  REACHED,  THE 
RECEIVE  SEQUENCE  NUMBER  IS  RESET  TO  THE 
LOWER  LIMIT. 


ARGUMENTS : 


RCV- BLOCK  *=  RECRD 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 


PINPMS  -  PROCESS  MESSAGE  FROM  OTHER  COMM 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COMVI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


UDXSQN 

UPDATE  TRANSMIT  SEQUENCE  NUMBER 

VAX- 11  COBOL 

SUBROUTINE 

UDXSQN 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  UDXSQN  INCREMENTS  THE  TRANSMIT  SEQUENCE  NUMBER. 
WHEN  THE  UPPER  LIMIT  IS  REACHED,  THE 
TRANSMIT  SEQUENCE  NUMBER  IS  RESET  TO  THE 
LOWER  LIMIT. 


ARGUMENTS : 


XMIT-BLOCK  -  RECRD 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 


CALLED  DIRECTLY  BY: 

ALRESP  -  RESPOND  TO  MESSAGE  FROM  OTHER  COMM 

USED  IN  MAIN  PROGRAM(S): 

COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


W1RESP 

WAIT  FOR  THE  FIRST 

VAX- 11  COBOL 

SUBROUTINE 

W1RESP 

.COB 

COMM 

COMM 


MESSAGE  ON  THE  LAN 


-  W1RESP  WAITS  FOR  EITHER  A  MESSAGE  FROM  THE 
COMM  ON  THE  OTHER  COMPUTER  OR  THE  TIMER  TO 
RUN  OUT.  IF  THE  TIMER  RUNS  OUT,  NTM  IS 
NOTIFIED  THAT  COMM  COULD  NOT  START  THE 
SESSION.  COMM  ALSO  NOTIFIES  NTM  THAT  IT  FAILED 
TO  START  THE  SESSION  IF  THE  MESSAGE  RECEIVED 
FROM  THE  OTHER  COMM  IS  NOT  THE  ONE  EXPECTED. 

THE  ACCEPTABLE  MESSAGES  ARE  LINE  CHECK  AND 
AND  LINE  BID  RESPONSE.  IF  THE  MESSAGE  FROM 
THE  OTHER  COMM  IS  CORRECT,  W1RESP  PUTS  THIS 
COMM  IN  THE  SESSION  ACTIVE,  LINE  IDLE  STATE. 

IF  THE  MESSAGE  IS  LINE  CHECK,  W1RESP  TRANSMITS 
A  LINE  BID  RESPONSE  MESSAGE. 

ANY  BAD  STATUS  CONDITIONS  IN  THIS  ROUTINE  ARE 
FATAL  TO  COMM. 


ARGUMENTS : 


LAN -EVENT -BLOCK  -  RECRD 
TIMER-EVENT-BLOCK  =  RECRD 
NTM-SEND-EVENT-BLOCK-H  =  DSPLY  [X(2032)l 
RCV- BLOCK  -  RECRD 
XMIT-BLOCK  -  RECRD 

TARGET -MAI LBOX-NAME-H  «  DSPLY  [X(14>] 

FLAGS  =  RECRD 

RET-STATUS  -  DSPLY  [X(5)] 
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INCLUDE  FILES 

COMCON 

ERRSTS 

CHKSTS 

LANEVB 

TIMEVB 

NHSNEB 

RCVBLK 

XMTBLK 

COMFLG 

ERRPRO 


COMCON  -  INCLUDE  FILE 
ERRSTS. INC  —  IISS  ERROR  CODES 
CHKSTS. INC  —  CHECK  STATUS 
LANEVB. INC  —  LAN  TERMINAL  EVENT  BLOCK 
DESCRIPTION 

TIMEVB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

NHSNEB  -  INCLUDE  FILE 

RCVBLK  -  INCLUDE  FILE 

XMTBLK  -  INCLUDE  FILE 

COMFLG  -  INCLUDE  FILE 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WAIT02 

CNLTIM 

GETLAN 

RCVLAN 

XMTMSG 

CNLLAN 

SCTLMS 

ERRPRO 


GET  A  MESSAGE  RECEIVED  FROM  A  LAN  TERMINAL  LINE 

RECEIVE  FROM  A  LAN  TERMINAL  LINE 

TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

CANCEL  A  LAN  TERMINAL  LINE  RECEIVE 

REPORT  RECOVERABLE  ERROR  OR  STATUS  MSG  TO  NTM 


CALLED  DIRECTLY  BY: 


ACTSES 


-  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 


USED  IN  MAIN  PROGRAM(S) : 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


XMTLAN 

TRANSMIT  TO  A  LAN  TERMINAL  LINE 

VAX- 11  COBOL 

SUBROUTINE 

XMTLAN 

.COB 

VAX 

COMM 

COMM 


DESCRIPTION : 


TRANSMIT  TO  A  TERMINAL  LINE  AND 
CONTINUE  PROCESSING.  ASSUME  THE 
DATA  WAS  TRANSMITTED  OK. 


ARGUMENTS : 


XMIT-BLOCK  =  RECRD 
LAN-EVENT-BLOCK  -  RECRD 
FLAGS  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

XMTBLK  -  XMTBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  --  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

COMFLG  -  COMFLG  -  INCLUDE  FILE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


XMTTRM  -  TRANSMIT  TO  THE  TERMINAL  LINE 

RCV5H  -  RECEIVE  5  CURSORS  FROM  THE  IBM 
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ERRPRO 


CALLED  DIRECTLY  BY: 


XMTMSG 


-  TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 


USED  IN  MAIN  PROGRAM(S) 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST : 


XMTMSG 

TRANSMIT  MESSAGE  TO  COMM  ON  OTHER  COMPUTER 

VAX- 11  COBOL 

SUBROUTINE 

XMTMSG 

.COB 


SUBSYSTEM :  COMM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP:  COMM 


DESCRIPTION: 


-  XMTMSG  GIVES  TO  THE  TRANSMIT  PRIMITIVE  THE 
COMPLETED  MESSAGE  TO  BE  SENT  TO  THE  COMM 
ON  THE  OTHER  COMPUTER.  IT  THEN  ISSUES  THE 
RECEIVE  FOR  THE  RETURNING  MESSAGE  AND 
IT  STARTS  A  TIMER  IN  CASE  THE  RETURNING 
MESSAGE  FAILS  TO  ARRIVE  IN  A  REASONABLE 
LENGTH  OF  TIME. 

ANY  BAD  STATUS  IN  THIS  ROUTINE  IS 
FATAL  TO  COMM. 


ARGUMENTS : 


FLAGS  -  RECRD 
XMIT-BLOCK  -  RECRD 
RCV- BLOCK  -  RECRD 
LAN-EVENT-BLOCK  =  RECRD 
TIMER-EVENT-BLOCK  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


COMCON  -  COMCON  -  INCLUDE  FILE 

CHKSTS  -  CHKSTS . INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS . INC  --  IISS  ERROR  CODES 

COMFLG  -  COMFLG  -  INCLUDE  FILE 
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XMTBLK  -  XHTBLK  -  INCLUDE  FILE 

RCVBLK  -  RCVBLK  -  INCLUDE  FILE 

LANEVB  -  LANEVB . INC  —  LAN  TERMINAL  EVENT  BLOCK 

DESCRIPTION 

TIMEVB  -  TIMEVB . INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


XMTLAN  -  TRANSMIT  TO  A  LAN  TERMINAL  LINE 

RCVLAN  -  RECEIVE  FROM  A  LAN  TERMINAL  LINE 

STRTIM  -  SET  APPROPRIATE  TIME  INTERVAL  AND  START  TIMER 

ERRPRO 


CALLED  DIRECTLY  BY: 


ACTSES  -  ACTIVATE  SESSION  IF  REQUESTED  TO  BY  NTM 

ALINPS  -  WAIT  FOR  INPUT  FROM  LAN  OR  TIMER  RUNOUT 

IDLINE  -  PROCESS  INPUT  OR  TIMER  RUNOUT 

KPLXMT  -  PUT  FINISHING  TOUCHES  ON  MESSAGE  TO  LAN 

LINBID  -  TRANSMIT  A  LINE  BID  MESSAGE 

W1RESP  -  WAIT  FOR  THE  FIRST  MESSAGE  ON  THE  LAN 


USED  IN  MAIN  PROGRAM ( S ) : 


COMVH  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

COM VI  -  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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COMM  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


XMTTRM 

TRANSMIT  TO  THE  TERMINAL  LINE 
VAX- 11  FORTRAN 
SUBROUTINE 
XMTTRM 
.FOR 
VAX 
COMM 

COMM 


DESCRIPTION: 


TO  TRANSMIT  TO  A  TERMINAL  ON  THE  LAN 


ARGUMENTS : 


CHANNL 

XMTBLK 

LENGTH 

RSTATS 


1*2 

TERMINAL  CHANNEL  NUMBER 
L*  1  (*) 

TRANSMIT  BLOCK 
1*2 

BUFFER  LENGTH 
CHAR 

RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS . INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  *»** 


ROUTINES  CALLED. 


ERRPRO 

SYSSQIOW 

SYSSSETPRI 


CALLED  DIRECTLY  BY: 


XMTLAN 


TRANSMIT  TO  A  LAN  TERMINAL  LINE 
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USED  IN  MAIN  PROGRAM(S): 


COMVH 
COM  VI 


-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 

-  MAIN  MODULE  FOR  COMMUNICATIONS  SUBSYSTEM 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 


3-131 


MS HTOVtW 


PS  620143100 
1  November  1985 


COMM  Include  File  Description 


FILE  NAME:  ASCII 

PURPOSE:  ASCII-  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  THIS  IS  THE  TABLE  USED  TO  IDENTIFY  THE 
VALID  SET  OF  ASCII  CHARACTERS. 

A  NEGATIVE  ENTRY  INDICATES  A  CONTROL 
CHARACTER  SUBSTITUTION  (JUST  NEGATE), 

A  POSITIVE  VALUE  YIELDS  THE  VALID 
CHARACTER  AND  A  ZERO  ENTRY  MEANS  AN 
INVALID  CHARACTER. 
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COMM  Include  File  Description 


FILE  NAME:  CANHDR 

PURPOSE:  CHESTS . INC  --  CHECK  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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COMM  Include  File  Description 


FILE  NAME:  CHKSTS 

PURPOSE:  CHKSTS. INC  —  CHECK  STATUS 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 
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COMM  Include  File  Description 


FILE  NAME:  GOMCON 

PURPOSE:  GOMCON  -  INCLUDE  FILE 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  COMOON  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  CONSTANTS  USED  IN  THE  COMM  SUBSYSTEM . 

EVENT  NUMBERS 
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COMM  Include  File  Description 


FILE  NAME:  COMFLG 

PURPOSE:  COMFLG  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  COMFLG  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  STORAGE  FOR  THE  FLAGS  BLOCK. 
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COMM  Include  File  Description 


FILE  NAME:  CTLASC 

PURPOSE :  CTLASC  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  THIS  TABLE  IS  USED  BY  KMINDA  TO 
SUBSTITUTE  THE  CORRECT  CONTROL 
CHARACTER  FOR  THE  CHARACTER  FOUND 
IN  THE  MESSAGE. 


THIS  TABLE  IS  COMPILED  WITH  THE  ASCII 
VERSIONS  OF  COMM  (NOT  FOR  IBM). 
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R 


COMM  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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OOMM  Include  File  Description 


FILE  NAME:  ERRSTS 

PURPOSE:  ERRSTS. INC  --  IISS  ERROR  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  FILE  CONTAINS  ALL  IISS  ERROR  CODES  DEFINED  IN 
COBOL  FORMAT 
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COMM  Include  File  Description 


FILE  NAME:  LANEVB 

PURPOSE:  LANEVB. INC  --  LAN  TERMINAL  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 
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COMM  Include  File  Description 


FILE  NAME:  NHSNEB 

PURPOSE:  NHSNEB  -  INCLUDE  FILE 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  DESCRIBES  THE  EVENT  BLOCK  USED  TO  SEND 

MESSAGES  TO  THE  HIGH  PRIORITY  NTH  QUEUE. 
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COMM  Include  File  Description 


FILE  NAME:  NLSNEB 

PURPOSE:  NLSNEB  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION : 


DESCRIPTION:  -  DESCRIBES  THE  EVENT  BLOCK  USED  TO  SEND 
MESSAGES  TO  THE  LOW  PRIORITY  NTM  QUEUE. 
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COMM  Include  File  Description 


FILE  NAME:  NRCVEB 

PURPOSE:  NRCVEB  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  NRCVEB  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  EVENT  BLOCK  USED  TO  RECEIVE 
MESSAGES  FROM  THE  NTM. 


3-143 


PS  620143100 
1  November  1985 


COHN  Include  File  Description 


FILE  NAME:  NTMHDR 

PURPOSE:  NTMHDR  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  THIS  FILE  DESCRIBES  THE  NTM  MESSAGE  FOR 
THE  PURPOSES  OF  THE  COMM  INTERFACE. 

IT  IS  ALWAYS  REFERENCED  DIRECTLY  AFTER 
THE  NTM  OUTPUT  BLOCK  (NTMOUB. INC) . 
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COMM  Include  File  Description 


FILE  NAME:  NTMINB 

PURPOSE:  NTMINB  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  NTMINB  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  "TO  NTM"  VARIABLES. 
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COMM  Include  File  Description 


FILE  NAME:  NTMOUB 

PURPOSE:  NTMOUB  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  NTMOUB  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  NTM -OUTPUT- BLOCK . 
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COMM  Include  File  Description 


FILE  NAME:  RCVBLK 

PURPOSE:  RCVBLK  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  RCVBLK  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  CONTENTS  OF  THE  RCV- BLOCK . 
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COMM  Include  File  Description 


FILE  NAME:  TIMEVB 

PURPOSE:  TIMEVB. INC  --  TIME  EVENT  BLOCK  DESCRIPTION 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 
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COMM  Include  File  Description 


FILE  NAME:  XMTBLK 

PURPOSE:  XMTBLK  -  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  -  XMTBLK  IS  AN  INCLUDE  FILE  THAT  DESCRIBES 
THE  CONTENTS  OF  THE  XMIT-BLOCK. 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentat j on . 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  am  external  routine. 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


“Testing*1  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed. 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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